CLI referenceastro deployment

astro deployment service-account

This command is available only if you’re authenticated to an Astronomer Software installation.

Manage Deployment-level service accounts, which you can use to configure a CI/CD pipeline or otherwise interact with the Astronomer Houston API.

Usage

This command includes three subcommands: create, delete, and list

1# Creates a Deployment-level service account
2astro deployment service-account create --deployment-id=<your-deployment-id> --label=<your-service-account-label>
3
4# Deletes a Deployment-level service account
5astro deployment service-account delete <your-service-account-label>
6
7# Shows the name, ID, and API token for each service account in a specific Deployment.
8astro deployment service-account list

Options

OptionDescriptionPossible Values
--categoryThe category for the new service account as displayed in the Software UIAny string. The default value is default.
--deployment-id (Required for create and delete)The Deployment you’re creating a service account forAny Deployment ID
--label (Required for create)The name or label for the new service accountAny string
--roleThe User Role for the new service accountCan be either viewer, editor, or admin. The default is viewer.