NAME
    gcloud alpha deploy targets rollback - rollbacks a target to a prior
        rollout

SYNOPSIS
    gcloud alpha deploy targets rollback (TARGET : --region=REGION)
        --delivery-pipeline=DELIVERY_PIPELINE [--annotations=[KEY=VALUE,...]]
        [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]]
        [--override-deploy-policies=[POLICY,...]] [--release=RELEASE]
        [--rollback-of-rollout=ROLLBACK_OF_ROLLOUT] [--rollout-id=ROLLOUT_ID]
        [--starting-phase-id=STARTING_PHASE_ID] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (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.

EXAMPLES
    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

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.

       --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.

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 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"

     --override-deploy-policies=[POLICY,...]
        Deploy policies to override

     --release=RELEASE
        Name of the release to rollback to.

     --rollback-of-rollout=ROLLBACK_OF_ROLLOUT
        If set, this validates whether the rollout name specified by the flag
        matches the rollout on the target.

        Examples:

        Validate that test-rollout is the rollout to rollback on the target.

            $ gcloud alpha deploy targets rollback \
                --rollback-of-rollout=projects/test-project/locations/\
            us-central1/deliveryPipelines/test-pipeline/releases/test-release/\
            rollouts/test-rollout

     --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 alpha 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
    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

