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

このページでは、Cloud Deploy デリバリー パイプラインを一時停止する方法について説明します。

デリバリー パイプラインを停止できます。パイプラインを停止すると、次の目的で使用できなくなります。

  • リリースを作成する

  • リリースを昇格する

  • リリースをロールバックする

  • リリースを再デプロイする

  • ロールアウトを承認または拒否する

デリバリー パイプラインを停止する理由は次のとおりです。

  • リリースに問題があるため、問題が見つかるまでそのパイプラインでこれ以上のアクションが行われないようにする必要がある。

  • 組織は、たとえば年末商戦の繁忙期の間など、休日中の停止を行う。

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

  1. デリバリー パイプラインの構成ファイルに、次のプロパティを含めます。

    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: []
    
  2. デリバリー パイプラインを登録します。

    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

停止されたデリバリー パイプラインを再開する

停止されたデリバリー パイプラインを再度有効にするには:

  1. デリバリー パイプライン構成ファイルで、プロパティ suspended: true を削除するか、false に設定します。

  2. 構成を適用します。

    gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
    

一時停止されているパイプラインを確認する

ロックされているデリバリー パイプラインは、Google Cloud コンソールの [デリバリー パイプライン] ビューの名前の横に鍵アイコンが表示されます。

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

次のステップ