This page describes how to promote an existing Cloud Deploy release to the next target in a delivery pipeline progression .
Before you begin
This page assumes you have already created a release .
Promote the release
When your release is deployed into a target defined in your delivery pipeline, you can promote it to the next target:
gcloud
gcloud
deploy
releases
promote
--release =
RELEASE_NAME
\
--delivery-pipeline =
PIPELINE_NAME
\
--region =
REGION
Where:
RELEASE_NAME
is the name of the release you're
promoting.
PIPELINE_NAME
is the name of the delivery pipeline
you're using to manage deployment of this release.
REGION
is the name of the region in which the release
was created, for example us-central1
. This is required.
See the Google Cloud SDK
reference for more information about the gcloud deploy releases promote
command
.
Console
-
Click your pipeline shown in the list of delivery pipelines.
The Delivery pipeline details page shows a graphical representation of your delivery pipeline's progress.
-
On the first target in the delivery pipeline visualization, click Promote.
The Promote releasedialog is shown. It shows the details of the target you're promoting to.
-
Click Promote.
If the delivery pipeline or target has changed since the release was created,
Cloud Deploy returns a message indicating a possible mismatch
, and prompts
you to confirm the promotion. You can respond n
to the prompt and examine the
differences between the pipeline versions before you proceed. If you choose to
promote anyway, the release is deployed according to the delivery pipeline as it
was defined when the release was created. See Pipeline instances per release
for more
information about pipeline mismatches.
Cloud Deploy creates a rollout
for the release into the
destination target, and the release is queued for deployment. When it's
deployed, the delivery pipeline visualization shows that fact:
Manage approvals for a delivery pipeline
You can require approval for any target, and you can approve or reject releases into that target.
Approvals can be managed programmatically by integrating your workflow management system (such as ServiceNow), or other system, with Cloud Deploy using Pub/Sub and the Cloud Deploy API.
Require approval
To require approval on any target, set requireApproval
to true
in the target
configuration:
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name:
description:
requireApproval: true
See Delivery pipeline configuration for further details.
When a rollout is pending approval, users or systems that subscribe to the clouddeploy-approvals
Pub/Sub topic receive notification, from the clouddeploy-approvals
topic, and can then approve or reject the rollout.
When using parallel deployment
, you can configure the
multi-target to require approval
.
If promotion to the target is rejected, the controller rollout fails, with a
state of APPROVAL_REJECTED
, and the child rollouts are not created.
Approve or reject a rollout
Any user or service account with the role roles/clouddeploy.approver
can
approve a Cloud Deploy rollout to a target that requires approval.
Your integrated workflow management system, having received an approval-required notification using service notifications , can approve or reject the rollout using the Cloud Deploy API.
Approve or reject manually
Console
-
In the Google Cloud console, navigate to the Cloud Deploy Delivery pipelinespage to view of list of your available delivery pipelines.
Open the Delivery pipelines page
The list of delivery pipelines is shown in Google Cloud console. Delivery pipelines that have been configured but not registered with the Cloud Deployservice are not shown.
-
Click the name of the delivery pipeline.
The pipeline visualization is shown. If approval is pending, and if you have the
roles/clouddeploy.approverrole, or equivalent permissions, the visualization includes a Reviewlink.
-
Click Review.
A list is shown of rollouts pending approval.
-
Click Review.
The Approve rollout screen is shown.
The Manifest difftab shows any changes to the rendered manifest from the currently deployed version (if any) to the one you're now approving (or rejecting).
-
Click Approveor Reject.
If you approve, your application is deployed into the target. If you reject, the application is not deployed, and can't be approved later unless re-promoted.
gcloud
A user with the roles/clouddeploy.approver
role can manually approve or
reject a rollout. To approve:
gcloud
deploy
rollouts
approve
rollout
-
name
--
delivery
-
pipeline
=
pipeline
-
name
\
--
region
=
region
\
--
release
=
release
-
name
To reject:
gcloud
deploy
rollouts
reject
rollout
-
name
--
delivery
-
pipeline
=
pipeline
-
name
\
--
region
=
region
\
--
release
=
release
-
name
