For the complete documentation index, see llms.txt. This page is also available as Markdown.

release deploys create

Command reference doc for the Release CLI

Deploys the latest changes from the tracking branch to the given environment

Description

If the --wait flag is passed, the command will exit with a non-zero exit code if the deploy fails.

If --force-setup is passed, the command will force the "Setup" workflow to run. Otherwise, it will run a "Patch" workflow if the environment has had a successful setup in the past and a "Setup" if not.

release deploys create [flags]

Examples


Trigger a deployment asynchronously:
> release deploys create --app backend --environment staging

Wait until the environment is deployed successfully before exiting and include log output:
> release deploys create --app backend --environment staging --wait --verbose

Force a "Setup" workflow to run:
> release deploys create --app backend --environment staging --setup

Force a "Setup" workflow with dataset refresh:
> release deploys create --app backend --environment staging --setup --refresh-dataset

Get environment and deploy details as JSON:
> release deploys create --app backend --environment staging --wait --verbose -o json > results.json

Options

--account <string>

Account name or ID (default: $RELEASE_ACCOUNT or "account" in config file)

--app <string>

App name or ID (default: $RELEASE_APP or "app" in config file)

--environment <string>

Environment handle or ID

-o, --output <string>

Set the output format (table | json | json-pretty)

--refresh-dataset

Refresh dataset when running setup (requires --setup)

--setup

Force the "Setup" workflow

--verbose

Verbose log output

--wait

Wait for environment deploy to complete before exiting

--workflow <string>

Name of custom workflow to run.

Options inherited from parent commands

--config <string>

config file (default is $HOME/.release.yaml)

--debug

enable debug logging

Last updated

Was this helpful?