Skip to main content

Quickstart: Your First Deployment

This guide walks you through the entire process of creating and executing a deployment, from selecting a template to watching your infrastructure come online. Assuming your Prerequisites are already in place, the process takes about 5–10 minutes.

Prerequisites

Before following this guide, make sure you have completed the Prerequisites checklist.

Overview​

You will complete the following steps:

  1. Create a Project
  2. Browse the template library and select a template
  3. Configure the deployment (variables + cloud environment)
  4. Execute the deployment (trigger a Run)
  5. Review and approve the plan
  6. Approve the apply
  7. Monitor completion and view outputs

Step 1 — Create a Project​

Projects organize your deployments. If you already have a suitable project, skip to Step 2.

  1. Navigate to Deploy in the top navigation
  2. Select your cloud provider (Azure, AWS, or GCP)
  3. Click New Project
  4. Enter a name (e.g., "My First Project")
  5. Optionally add a description and tags
  6. Click Create Project

Your new project appears in the project list. You will assign your first deployment to it in the next steps.

Step 2 — Browse Templates and Select One​

  1. From the Deploy section, click Templates in the sidebar
  2. Browse the available templates by category, or use the search bar to find one by name
  3. Review the template description to understand what infrastructure it provisions
  4. When you find the right template, click Use Template to begin creating a deployment
tip

Not sure which template to start with? Look for one in the Infrastructure category that matches your cloud provider. Start simple — you can always create more complex deployments later.

Step 3 — Configure the Deployment​

The Deployment Creation wizard guides you through each configuration step.

3a. Basic Details

  • Enter a name for this deployment (e.g., "EU Production Cluster")
  • Optionally add a description
  • Select the Project you created in Step 1

3b. Template Variables

  • Fill in all required variable fields (marked with an asterisk)
  • For sensitive variables (passwords, keys), enter the value — it will be stored securely and not displayed again
  • Some variables may offer a dropdown of allowed values — select from the list
  • Some variables may let you browse existing cloud resources (e.g., a resource group from your Azure subscription) — use the picker to select one

3c. Cloud Environment

  • Select the cloud provider (Azure, AWS, or GCP)
  • Select the region to deploy into
  • Select the account or subscription to use

3d. Tags (Optional)

  • Add any key–value tags to this deployment for organization or cost tracking

3e. Review

  • Review all your choices before creating the deployment
  • Click Create Deployment

The deployment is created but has not provisioned any infrastructure yet. That happens in the next step.

Step 4 — Execute the Deployment​

On the Deployment detail page:

  1. Click Execute
  2. Amnify Deploy creates a new Run and begins the execution process
  3. The status shows Queued → Initializing → Planning as the system prepares

Wait for the status to reach Awaiting Plan Approval — this usually takes less than a minute.

Step 5 — Review and Approve the Plan​

When the status reaches Awaiting Plan Approval, the plan is ready for your review.

  1. Open the Run detail (click on the current run in the Runs list)
  2. Read the plan output — it shows a precise list of every cloud resource that will be created, modified, or deleted
  3. Verify the plan matches your expectations:
    • Are the correct resources being created?
    • Is the count of new resources what you expected?
    • Are there any unexpected modifications or deletions?
  4. If the plan looks correct, click Approve Plan
  5. If anything looks wrong, click Cancel — nothing has been changed yet, and you can edit the deployment and try again

Step 6 — Approve the Apply​

After approving the plan, the status moves to Awaiting Apply Approval. This is your final confirmation before changes are made.

  1. Click Approve Apply to proceed
  2. The status moves to Applying and infrastructure provisioning begins

Step 7 — Monitor Completion​

While the run is in Applying state, the execution log streams in real time so you can follow the progress of each resource being created.

When the run completes:

  • Status shows Completed
  • The Outputs section (if your template produces outputs) shows values like endpoint URLs, IP addresses, or resource identifiers — copy these and share them with your team to connect applications to the newly provisioned infrastructure

You Did It​

Your infrastructure is now deployed and running in the cloud. From the Deployment detail page you can:

  • View the run history
  • Edit the deployment variables and re-execute to apply changes
  • Execute a Destroy run when the infrastructure is no longer needed

Next Steps​