Skip to main content

Don't miss the biggest Airflow event of the year: Airflow Summit 2023, Sept 19-21

Join Us →

Create a Deployment

An Astro Deployment is an Airflow environment that is powered by Astro Runtime. It runs all core Airflow components, including the Airflow webserver, scheduler, and workers, plus additional tooling for reliability and observability.

There are three ways to create a Deployment:

  • Manually, using the Cloud UI. This is the most basic way to create a Deployment and is the focus of this document.
  • Programmatically, using astro deployment create.
  • Programmatically, using a Deployment template file. See Manage Deployments as code.

After you create a Deployment, you can deploy DAGs to it using the Astro CLI on your local machine or a continuous integration/continuous delivery (CI/CD) tool. All DAGs and tasks on Astro are executed within a Deployment.

Every Deployment is hosted on an Astro cluster with its own dedicated resources that you can customize to fine-tune your resource usage. To restrict communication between Deployments, resources for each Deployment are isolated within a corresponding Kubernetes namespace. See Deployment network isolation.


Create a Deployment

  1. In the Cloud UI, go to Deployments.

  2. Click + Deployment.

    Deployment creation button

  3. Enter a Name for the Deployment.

  4. (Optional) Configure other details for your Deployment, including cluster, executor, and worker resources. If you have no specific resource requirements for running Airflow, the default configurations should work in most cases. For all available Deployment options, see Deployment settings.

  5. Click Create Deployment.

    A confirmation message appears indicating that the Deployment is in progress. The Deployment status is Creating until all underlying components in your Astro cluster are healthy, including the Airflow webserver and scheduler. During this time, the Airflow UI is unavailable and you can't deploy code or modify Deployment settings. When the Deployment is ready, the status changes to Healthy.

You can continue to access your other Deployments by selecting the Deployments link.

For more information about possible Deployment health statuses, see Deployment health.

Next steps

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.