astro deployment variable create

This command is only available on Astro.

For a given Deployment on Astro, create environment variables in the Astro CLI by supplying either a key and value pair or a file (for example, .env) with a list of keys and values. This command is functionally identical to creating an environment variable in the Astro UI. See Set Environment Variables on Astro.

Usage

astro deployment variable create <key>=<value>

This command is recommended for automated workflows. To run this command in an automated process such as a CI/CD pipeline, you can generate an API token, then specify the ASTRO_API_TOKEN environment variable in the system running the Astro CLI:

export ASTRO_API_TOKEN=<your-token>

See Organization, Workspace, and Deployment API token documentation for more details about ways to use API tokens.

Options

Option	Description	Possible Values
`-d`,`--deployment-id`	The ID of the Deployment in which to create environment variable(s).	Any valid Deployment ID
`--deployment-name`	The name of the Deployment in which to create environment variable(s). Use as an alternative to `<deployment-id>`.	Any valid Deployment name
`-e`,`--env`	The path to a file that contains a list of environment variables. If a filepath isn’t specified, this looks for a `.env` file in your current directory. If `.env` doesn’t exist, this flag will create it for you	Any valid filepath
`-l`,`--load`	Export new environment variables from your Astro project’s `.env` file to the Deployment. This is an alternative to creating an environment variable by manually specifying `--key` and `--value`. By default, this flag exports all new environment variables based on the file specified with `--env`	“
`-s`,`--secret`	Set the value of the new environment variable as secret	“
`-w`,`--workspace-id`	Create or update an environment variable for a Deployment that is not in your current Workspace. If this is not specified, your current Workspace is assumed	Any valid Workspace ID

Examples

# Create a new secret environment variable
$ astro deployment variable create --deployment-id cl03oiq7d80402nwn7fsl3dmv AIRFLOW__SECRETS__BACKEND_KWARGS=<my-secret-value> --secret

# Create multiple environment variables for a Deployment at once by specifying multiple keys
$ astro deployment variable create AIRFLOW__CORE__PARALLELISM=32 MAX_ACTIVE_TASKS_PER_DAG=16 --deployment-id cl03oiq7d80402nwn7fsl3dmv

# Create multiple environment variables for a Deployment at once by loading them from a .env file
$ astro deployment variable create --deployment-name="My Deployment" --load --env .env.dev

Usage

Options

Examples

Related commands