Skip to main content

astrocloud deployment variable create

Description

For a given Deployment on Astro, create environment variables via the Astro CLI by supplying either a key and value pair or a file (e.g. .env) with a list of keys and values. This command is functionally identical to creating an environment variable via the Cloud UI. For more information, see Set Environment Variables on Astro.

If you choose to specify --key and --value instead of loading a file, you can only create one environment variable at a time.

tip

This command has an --update flag that allows you to change the value of an existing environment variable at any time. For a better user experience, we recommend using the astrocloud deployment variable update command to update environment variables instead.

Usage

astrocloud deployment variable create

Options

OptionDescriptionPossible Values
-d,--deployment-idThe Deployment in which to create environment variable(s)Any valid Deployment ID
-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
-k,--keyThe environment variable keyAny string
-l,--loadLoad new environment variables from a file. Specify this flag if the variables you want to create are in that file. This is an alternative to creating an environment variable by manually specifying --key and --value``
-s,--secretSet the value of the new environment variable as secret``
-u,--updateUpdate the value of an existing environment variable. Make sure to specify the --key to which this new value will be appliedAny string
-v,--valueThe environment variable value``
-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

Examples

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

# Create multiple environment variables for a Deployment at once by loading them from a .env file
$ astrocloud deployment variable create --deployment-id cl03oiq7d80402nwn7fsl3dmv --load --env .env.dev

# Update the value of an existing environment variable
$ astrocloud deployment variable create --deployment-id cl03oiq7d80402nwn7fsl3dmv --update --key AIRFLOW__CORE__PARALLELISM --value <my-new-value>