デリバリーパイプラインを停止する

このページでは、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 コンソールの [デリバリーパイプライン] ビューの名前の横に鍵アイコンが表示されます。

デリバリーパイプラインが停止していることを示す鍵アイコン。

次のステップ

すでに使用されているデリバリーパイプラインを表示する方法を確認する。
デリバリーパイプラインを更新する方法を学習する。
デリバリーパイプラインを削除する方法を確認する。
サービス通知を使用する方法を確認する

デリバリー パイプラインを停止する

停止されたデリバリー パイプラインからのロールアウト