Skip to main content

Managing Projects

Projects are the organizational backbone of Amnify Deploy. This guide covers how to create, edit, and navigate your projects effectively.

Creating a Project​

  1. Navigate to Deploy in the Amnify platform

  2. Select the cloud provider this project is associated with (Azure, AWS, or GCP)

  3. Click New Project

  4. Fill in the project details:

    FieldRequiredDescription
    NameYesA short, recognizable name (e.g., "Platform Team — Prod")
    DescriptionNoA longer explanation of the project's purpose
    TagsNoKey–value pairs for categorization (e.g., team: platform, env: production)

  5. Click Create Project

The project is created immediately and you are taken to the project detail page.

Editing a Project​

You can update a project's name, description, and tags at any time. Editing a project does not affect its deployments.

  1. Open the project you want to edit
  2. Click the Edit button (or the settings icon) on the project detail page
  3. Update the fields as needed
  4. Save your changes

Adding Tags​

Tags are key–value pairs that help you categorize and filter projects. The examples below show a common key: value convention — this is not a required format, just a readable one. Use whatever tag format works for your organization.

By environment:

env: production
env: staging
env: development

By team or owner:

team: platform
owner: data-engineering

By cost center:

cost-center: engineering
budget-code: PLAT-2024

Consistent tagging across projects makes filtering and reporting much easier.

Viewing Deployments in a Project​

From the project detail page, you can see all Deployments that belong to the project, including their name and description, current status (active, never executed, failed, etc.), and when they were last executed.

Click on any Deployment to open its detail page, where you can view run history, edit variables, or trigger a new run.

Searching and Filtering Projects​

On the main Deploy dashboard (per cloud provider), you can:

  • Search by project name or description using the search bar
  • Filter by tags to narrow down projects belonging to a specific team or environment
  • Sort by creation date or name

Organizing Projects at Scale​

As your use of Amnify Deploy grows, keeping projects organized becomes more important. Recommended practices:

  • Use consistent naming conventions — for example, [Team] — [Environment] or [Product] — [Region]
  • Always fill in descriptions — a clear description helps teammates quickly understand what a project is for
  • Tag consistently — agree on a tagging schema across your organization and apply it to every project
  • Clean up unused projects — delete projects that are no longer needed to keep the dashboard uncluttered

Deleting a Project​

caution

Before deleting a project, make sure all its Deployments have been destroyed and you no longer need them. Deleting a project does not automatically destroy the cloud resources — you must destroy each Deployment separately first.

To delete a project:

  1. Open the project detail page
  2. Destroy all Deployments within the project (if not already done)
  3. Click Delete Project
  4. Confirm the deletion

Next Steps​