Deployment details

Deployment details define how users can view and interact with your Deployment. They include metadata settings, observability settings, and user access settings.

Update a Deployment name and description

1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.

2. Click the More Actions menu of the Deployment you want to update, and select Edit Deployment.

3. In the Basic section, update the Deployment Name or Description.

4. Click Update Deployment.

Configure Deployment contact emails

Configure a contact email to get proactive alerts directly from Astronomer support. Astronomer support uses contact emails to notify recipients in case there’s an issue with the infrastructure for your Deployment, such as a problem with your scheduler or worker components.

1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.

2. Click the Details tab. In the Advanced menu, click Edit.

3. To add an alert email:

   • In the Contact Emails section, click Add Email.
   • Enter an email address and then click Add.

4. To delete an alert email address:

   • In the Contact Emails section, click Delete next to the email you want to delete.
   • Click Yes, Continue.

In addition to alert emails for your Deployments, Astronomer recommends configuring Astro alerts and subscribing to the Astro status page. When you subscribe to the status page, you’ll receive email notifications about system-wide incidents as they happen.

Fallback emails

For Deployments without a contact email set, Astronomer sets a fallback value to ensure critical issues don’t get missed. To see the fallback values for a Deployment without a contact email, go to the Details tab and find Contact Emails in the Advanced section. To override the fallback values displayed, set a contact email. We recommend that every Astro Deployment have a contact email set to ensure timely receipt of notifications.

For Deployments without a contact email, Astronomer uses the Deployment Creator as the fallback. For Deployments without a valid Deployment Creator, Astro uses Workspace Owners. In Workspaces without an Owner, Astro uses Organization Owners. Check that your Deployments, Workspaces, and Organizations each have a valid owner to ensure that key support communications don’t get missed.

Enforce CI/CD deploys

By default, any user can deploy code either directly from the Astro CLI or from a CI/CD process that is authenticated with an API token. To help your team protect production environments from manual code deploys that circumvent your organization’s CI/CD processes and checks, you can configure a Deployment so that users can’t deploy code manually using the Astro CLI.

After you enable CI/CD enforcement on a Deployment, the Deployment accepts a deploy only if the deploy is authenticated using a Deployment API token, Workspace API token, or Organization API token. Astronomer recommends enabling this setting for all production environments.

1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.

2. Click the More Actions menu of the Deployment you want to update, and select Edit Deployment.

3. In the Advanced section, find CI/CD Enforcement and click the toggle to On.

You can also update your Workspace so that any new Deployments in the Workspace enforce CI/CD deploys by default. See Update general Workspace settings.

Delete a Deployment

When you delete a Deployment, all infrastructure resources assigned to the Deployment are immediately deleted.

1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.
2. Click the More Actions menu of the Deployment you want to delete, and select Delete Deployment.

3. Enter Delete and click Yes, Continue.

Find Deployment external IP addresses

Each Astro Deployment has its own external IP addresses. Allowlist these addresses on any external service as a first step to create a connection between the Deployment and the service.

1. In the Astro UI, select a Workspace, click Deployments, and then select a Deployment.
2. Select the Details tab.
3. In the Other section, you can find the External IPs associated with the Deployment.