astro deployment inspect

Inspect a Deployment.

This command is only available on Astro.

Inspect an Astro Deployment. This command returns a YAML or JSON representation of a Deployment’s current configuration and state as shown in the Astro UI. When the --key flag is used, it returns only the values specified with the flag.

For more information about how to use Deployment files, see Manage Deployments as Code.

Usage

astro deployment inspect

When using the --key flag, specify the complete path of the key you want to return the value for, excluding deployment. For example, to return the cluster_id for a specific Deployment, you would run:

astro deployment inspect -n <deployment-name> --key metadata.cluster_id

See Template file contents for all possible values to return.

Options

Option	Description	Possible Values
<deployment-id>	The ID of the Deployment to inspect.	Any valid Deployment ID
-n, --deployment-name	Name of the Deployment to inspect. Use as an alternative to <deployment-id>.	Any valid Deployment name
-k, --key	Return only a specific configuration key for a Deployment. For example --key configuration.cluster_id to get a Deployment’s cluster ID.	Any valid Deployment configuration key
-o, --output	Output format can be one of: YAML or JSON. By default, inspecting a Deployment returns a file in YAML format.	yaml or json
--show-workload-identity	Return the workload identity values that are set for the Deployment.	None
-t, --template	Generate a Deployment template file for the inspected Deployment. A template file is a configuration file that includes all information about a Deployment at the time of inspection, except for its name, description field, and unique metadata. See Manage with Deployment files to learn more about templates.	None
--workspace-id	Specify a Workspace to run this command for a Deployment that is outside of your current Workspace.	Any valid Workspace ID

Examples

# Shows a list of Deployments to inspect and prompts you to choose one
$ astro deployment inspect

# Shows a specific Deployment's configuration
$ astro deployment inspect <deployment-id>

# Shows a specific Deployment's health status
$ astro deployment inspect <deployment-id> --key metadata.status

# Save the current state of a Deployment to a YAML Deployment file
$ astro deployment inspect <deployment-id> > deployment.yaml

# Save a Deployment as a JSON template file
$ astro deployment inspect <deployment-id> --template -o json > deployment.json

Related Commands

• astro deployment list
• astro deployment create