このページでは、Cloud Deploy デリバリー パイプラインを一時停止する方法について説明します。
デリバリー パイプラインを停止できます。パイプラインを停止すると、次の目的で使用できなくなります。
リリースを作成する
リリースを昇格する
リリースをロールバックする
リリースを再デプロイする
ロールアウトを承認または拒否する
デリバリー パイプラインを停止する理由は次のとおりです。
リリースに問題があるため、問題が見つかるまでそのパイプラインでこれ以上のアクションが行われないようにする必要がある。
組織は、たとえば年末商戦の繁忙期の間など、休日中の停止を行う。
デリバリー パイプラインを停止するには:
デリバリー パイプラインの構成ファイルに、次のプロパティを含めます。
suspended: true
このプロパティは、次のように最上位に位置します。
apiVersion: deploy.cloud.google.com/v1 kind: DeliveryPipeline metadata: Name: my-app description: main application pipeline suspended: true serialPipeline: stages: - targetId: dev profiles: [] - targetId: staging profiles: [] - targetId: prod profiles: []
デリバリー パイプラインを登録します。
gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
ここで
PIPELINE_CONFIG
は、デリバリー パイプライン構成ファイルの名前です。通常は
clouddeploy.yaml
です。必須入力項目です。REGION
は、デリバリー パイプラインが作成されたリージョンの名前です(例:
us-central1
)。必須入力項目です。PROJECT_ID
は、デリバリー パイプラインが作成されたプロジェクトのプロジェクト ID です。必須入力項目です。
デリバリー パイプラインが停止状態になり、リリースの作成、昇格、ロールバックと再デプロイ、ロールアウトの承認が行われなくなります。
停止されたデリバリー パイプラインからのロールアウト
デリバリー パイプラインを停止したときに、進行中のロールアウトやキューへの追加のロールアウトがある場合、それらのロールアウトは完了するまで続行され、キャンセルされません。ただし、リリースの作成や昇格はできないため、そのパイプラインを使用して再開するまで新しいロールアウトは作成できません。
パイプラインの停止に必要な IAM 権限
デリバリー パイプラインを停止するために必要な IAM 権限は、次のロールに含まれています。
roles/clouddeploy.admin
roles/clouddeploy.operator
roles/clouddeploy.developer
停止されたデリバリー パイプラインを再開する
停止されたデリバリー パイプラインを再度有効にするには:
デリバリー パイプライン構成ファイルで、プロパティ
suspended: true
を削除するか、false
に設定します。構成を適用します。
gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
一時停止されているパイプラインを確認する
ロックされているデリバリー パイプラインは、Google Cloud コンソールの [デリバリー パイプライン] ビューの名前の横に鍵アイコンが表示されます。
次のステップ
すでに使用されているデリバリー パイプラインを表示する方法を確認する。
デリバリー パイプラインを更新する方法を学習する。
デリバリー パイプラインを削除する方法を確認する。
サービス通知を使用する方法を確認する