gcloud: Wed Mar 29 10:40:15 UTC 2023

gcloud/deploy/releases/create

@@ -12,7 +12,8 @@ SYNOPSIS
         [--build-artifacts=BUILD_ARTIFACTS | --images=[NAME=TAG,...]]
         [--disable-initial-rollout | --enable-initial-rollout
           --initial-rollout-annotations=[KEY=VALUE,...]
-          --initial-rollout-labels=[KEY=VALUE,...]]
+          --initial-rollout-labels=[KEY=VALUE,...]
+          --initial-rollout-phase-id=INITIAL_ROLLOUT_PHASE_ID]
         [--from-k8s-manifest=FROM_K8S_MANIFEST
           | --from-run-manifest=FROM_RUN_MANIFEST
           | --skaffold-file=SKAFFOLD_FILE --source=SOURCE; default="."]
@@ -183,6 +184,17 @@ FLAGS
               $ gcloud deploy releases create \
                   initial-rollout-labels="commit=abc123,author=foo"
 
+       --initial-rollout-phase-id=INITIAL_ROLLOUT_PHASE_ID
+          The phase to start the initial rollout at when creating the release.
+          The phase ID must be a valid phase on the rollout. If not specified,
+          then the rollout will start at the first phase.
+
+          Examples:
+
+          Start rollout at stable phase:
+
+              $ gcloud deploy releases create --initial-rollout-phase-id=stable
+
      At most one of these can be specified:
 
        --from-k8s-manifest=FROM_K8S_MANIFEST

gcloud/deploy/releases/promote

@@ -7,8 +7,8 @@ SYNOPSIS
         (--release=RELEASE
           : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION)
         [--annotations=[KEY=VALUE,...]] [--labels=[KEY=VALUE,...]]
-        [--rollout-id=ROLLOUT_ID] [--to-target=TO_TARGET]
-        [GCLOUD_WIDE_FLAG ...]
+        [--rollout-id=ROLLOUT_ID] [--starting-phase-id=STARTING_PHASE_ID]
+        [--to-target=TO_TARGET] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     If to-target is not specified the command promotes the release from the
@@ -85,6 +85,13 @@ OPTIONAL FLAGS
      --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 releases promote --starting-phase-id=stable
+
      --to-target=TO_TARGET
         Destination target to promote into.
 

gcloud/deploy/targets/redeploy

@@ -5,7 +5,8 @@ SYNOPSIS
     gcloud deploy targets redeploy (TARGET : --region=REGION)
         --delivery-pipeline=DELIVERY_PIPELINE [--annotations=[KEY=VALUE,...]]
         [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]]
-        [--rollout-id=ROLLOUT_ID] [GCLOUD_WIDE_FLAG ...]
+        [--rollout-id=ROLLOUT_ID] [--starting-phase-id=STARTING_PHASE_ID]
+        [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Redeploy the last rollout that has a state of SUCCESSFUL or FAILED to a
@@ -78,6 +79,13 @@ OPTIONAL FLAGS
      --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 redeploy --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,

gcloud/deploy/targets/rollback

@@ -5,7 +5,8 @@ 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] [GCLOUD_WIDE_FLAG ...]
+        [--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
@@ -82,6 +83,13 @@ OPTIONAL FLAGS
      --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,