- Getting Started
- Security Model
- Airflow Deployments
- Astro CLI
- Houston API
- Enterprise Edition
- Getting Started
Deploying to Astronomer Enterprise
If you've created and tested your Airflow DAG locally via the astro-cli, you're ready to deploy that DAG to your Astronomer EE cluster.
(Note: If you're looking for steps on how to deploy to your Astronomer Cloud account, check out our Getting Started with Cloud guide).
Authenticating With Your Registry
1) Configure the location of your Private Docker Registry
The first setting we need to configure is the location of your private Docker registry.
This houses all Docker images pushed to your Astronomer EE deploy. By default, it's located at
- If you're not sure which domain you deployed Astronomer EE to, you can refer back to the
Run the following command from your project root directory:
astro auth login [baseDomain]
Note: Depending on the type of authentication you're using, the process will be a little different. If you are using the default Google OAuth, leave the Username field blank and continue follow the instructions on the terminal.
3) List your Workspaces
astro workspace list to see a list of all the workspaces you have access to.
To switch between workspaces, run:
astro workspace switch [UUID]
Now that you've configured the astro-cli to point at your Astronomer EE deployment, you're ready to push your first DAG.
1. Find your Release Name
To push your DAG, you'll need the release name of your Astronomer EE deployment. A few notes:
This release name was created by the Helm package manager during your Astronomer EE deploy
If you are unsure of what release name was created for your deploy, you can run
helm lsto get a list of all Helm releases and find the one that has an "Updated" timestamp corresponding to the time at which you deployed Astronomer EE.
If you're still not sure which Helm release you should deploy to, reach out to your cluster Administrator.
2. Run our deploy command
astro airflow deploy [release-name]
If you do NOT include a release name, you will be prompted to choose from a deployment in the workspace you are pointing to.
After deploying, you'll see some stdout as the CLI builds and pushes images to your private registry.
3. Check your Instance
After a deploy, you should see your updated instance.
If you're running our Enterprise Edition, go to
app.[baseDomain] to view your list of deployments and workspace.
If you're running our Cloud Edition, go to: https://app.astronomer.cloud/deployments