- NAME
-
- gcloud deploy targets rollback - rollbacks a target to a prior rollout
- SYNOPSIS
-
-
gcloud deploy targets rollback
(TARGET
:--region
=REGION
)--delivery-pipeline
=DELIVERY_PIPELINE
[--annotations
=[KEY
=VALUE
,…]] [--description
=DESCRIPTION
] [--labels
=[KEY
=VALUE
,…]] [--release
=RELEASE
] [--rollout-id
=ROLLOUT_ID
] [--starting-phase-id
=STARTING_PHASE_ID
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
- 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.
- EXAMPLES
-
To rollback a target 'prod' for delivery pipeline 'test-pipeline' in region
'us-central1', run:
gcloud deploy targets rollback prod --delivery-pipeline=test-pipeline --region=us-central1
- POSITIONAL ARGUMENTS
-
-
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.
-
provide the argument
--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
.
-
provide the argument
-
provide the argument
-
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.
- REQUIRED FLAGS
-
--delivery-pipeline
=DELIVERY_PIPELINE
- The name of the Cloud Deploy delivery pipeline
- OPTIONAL FLAGS
-
--annotations
=[KEY
=VALUE
,…]-
Annotations to apply to the rollback. Annotations take the form of key/value
string pairs.
Examples:
Add annotations:
gcloud 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 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.
--starting-phase-id
=STARTING_PHASE_ID
-
If set, starts the created rollout at the specified phase.
Start rollout at
stable
phase:gcloud deploy targets rollback --starting-phase-id=stable
- GCLOUD WIDE FLAGS
-
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. - NOTES
-
These variants are also available:
gcloud alpha deploy targets rollback
gcloud beta deploy targets rollback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-06 UTC.