CLI referenceastro deployment

astro deployment delete

The behavior and format of this command differs depending on what Astronomer product you’re using. Use the following tabs to change product contexts.

Delete a Deployment on Astro. This command is functionally identical to deleting a Deployment in the Astro UI.

When you run astro deployment delete, you are prompted to select from a list of Deployments that you can access in your Workspace. You can bypass this prompt and specify a Deployment name or ID in the command. To retrieve a Deployment ID, open your Deployment in the Astro UI and copy the value in the ID section of the Deployment page. You can also run astro deployment list to find a Deployment ID or name.

To complete this action, Workspace Owner permissions are required.

Usage

1astro deployment delete

Options

OptionDescriptionPossible Values
<deployment-id>The ID of the Deployment to deleteAny valid Deployment ID
-f,--forceDo not include a confirmation prompt before deleting the DeploymentNone
--workspace-idSpecify a Workspace to delete a Deployment outside of your current WorkspaceAny valid Workspace ID
--deployment-nameThe name of the Deployment to delete. Use as an alternative to <deployment-id>.Any valid Deployment name

Examples

1$ astro deployment delete
2# CLI prompts you for a Deployment to delete
3$ astro deployment delete ckvvfp9tf509941drl4vela81n -f
4# Force delete a Deployment without a confirmation prompt
5$ astro deployment delete --deployment-name="My deployment"
6# Delete a Deployment by specifying its name.