gcloud alpha deploy targets rollback - rollbacks a target to a prior rollout
gcloud alpha deploy targets rollback (TARGET : --region=REGION) --delivery-pipeline=DELIVERY_PIPELINE [--annotations=[KEY=VALUE,...]] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--release=RELEASE] [--rollout-id=ROLLOUT_ID] [GCLOUD_WIDE_FLAG ...]
(ALPHA) If release is not specified, the command rollbacks the target with the last successful deployed release. If optional rollout-id parameter is not specified, a generated rollout ID will be used.
To rollback a target 'prod' for delivery pipeline 'test-pipeline' in region 'us-central1', run:
$ gcloud alpha deploy targets rollback prod \ --delivery-pipeline=test-pipeline --region=us-central1
- Target resource - The name of the Target. The arguments in this group can be
used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute:
- —
provide the argument target on the command line with a fully specified name;
- —
provide the argument --project on the command line;
- —
set the property core/project.
This must be specified.
- TARGET
ID of the target or fully qualified identifier for the target. To set the target attribute:
provide the argument target on the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
- --region=REGION
The Cloud region for the target. Alternatively, set the property [deploy/region]. To set the region attribute:
provide the argument target on the command line with a fully specified name;
provide the argument --region on the command line;
set the property deploy/region.
- --delivery-pipeline=DELIVERY_PIPELINE
The name of the Cloud Deploy delivery pipeline
- --annotations=[KEY=VALUE,...]
Annotations to apply to the rollback. Annotations take the form of key/value string pairs.
Examples:
Add annotations:
$ gcloud alpha deploy targets rollback \ --annotations="from_target=test,status=stable"
- --description=DESCRIPTION
Description of rollout created during a rollback.
- --labels=[KEY=VALUE,...]
Labels to apply to the rollback. Labels take the form of key/value string pairs.
Examples:
Add labels:
$ gcloud alpha deploy targets rollback \ --labels="commit=abc123,author=foo"
- --release=RELEASE
Name of the release to rollback to.
- --rollout-id=ROLLOUT_ID
ID to assign to the generated rollout for promotion.
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:
$ gcloud deploy targets rollback
$ gcloud beta deploy targets rollback