Skip to main content

Don't miss the biggest Airflow event of the year: Airflow Summit 2023, Sept 19-21

Join Us →

astro deployment variable create

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 Cloud UI. See Set Environment Variables on Astro.


astro deployment variable create <key>=<value>

To create environment variables in an automated process such as a CI/CD pipeline, set the following OS-level environment variables in a way that the Astro CLI can access them:


After setting these variables, astro deployment variable create works for your Deployment on Astro and you don't need to manually authenticate to Astronomer. Astronomer recommends storing ASTRONOMER_KEY_SECRET as a secret before using it to programmatically update production-level Deployments.


OptionDescriptionPossible Values
-d,--deployment-idThe ID of the Deployment in which to create environment variable(s).Any valid Deployment ID
--deployment-nameThe name of the Deployment in which to create environment variable(s). Use as an alternative to <deployment-id>.Any valid Deployment name
-e,--envThe 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 youAny valid filepath
-l,--loadExport 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,--secretSet the value of the new environment variable as secret``
-w,--workspace-idCreate or update an environment variable for a Deployment that is not in your current Workspace. If this is not specified, your current Workspace is assumedAny valid Workspace ID


# 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

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.