CodePipeline でのステージ移行の操作

移行は、無効化または有効化できるパイプラインステージ間のリンクです。デフォルトでは有効化されています。無効化された移行を再度有効化すると、30 日が経過していない限り、パイプラインの残りのステージで最新リビジョンが実行されます。パイプラインを実行しても、新しい変更が検出されるか、手動でパイプラインを再実行する場合を除き、無効期間が 31 日以上の移行が再開されることはありません。

AWS CodePipeline コンソールまたは AWS CLI を使用して、パイプラインのステージ間の移行を無効化または有効化できます。

注記

手動で承認するまでパイプラインの実行を停止するには、承認アクションを使用します。詳細については、「CodePipeline の承認アクションを管理する」を参照してください。

移行を無効化または有効化する (コンソール)

パイプラインで遷移を無効/有効にするには

1. AWS Management Console にサインインして、CodePipeline コンソール https://console.aws.amazon.com/codesuite/codebuild/home を開きます。

   AWS アカウントに関連付けられているすべてのパイプラインの名前が表示されます。

2. [Name] で、遷移を有効または無効にするパイプラインの名前を選択します。これにより、パイプラインの詳細ビューが開いて、パイプラインのステージ間の遷移がわかります。

3. 実行する最後のステージの後の矢印を見つけ、その横にあるボタンを選択します。たとえば、以下のパイプラインの例で、[Staging (ステージング)] ステージのアクションを実行するが、[Production (本番稼働用)] という名前のステージのアクションを実行しないようにするには、その 2 つのステージの間の [Disable transition (移行を無効にする)] ボタンを選択します。

   

4. [移行を無効にする] ダイアログボックスで、移行を無効にする理由を入力し、[無効化] を選択します。

   ボタンは、矢印の前のステージと矢印の後のステージとの間で遷移が無効にされたことを示すように変わります。無効にされた移行の後のステージですでに実行されていたリビジョンは、パイプラインにより続行されますが、それ以降のリビジョンは、無効にされた移行の後には続行されません。

   

5. 矢印の横にある [移行を有効にする] ボタンを選択します。[Enable transition] ダイアログボックスで、[Enable] を選択します。パイプラインはすぐに 2 つのステージ間の移行を有効にします。移行が無効にされた後、初期ステージで実行されていたリビジョンがある場合、パイプラインはすぐに、以前の無効にされた移行の後のステージで最新のリビジョンの実行を開始します。パイプラインは、そのリビジョンをパイプラインの残りのすべてのステージで実行します。

   注記

   遷移を有効にした後、CodePipeline コンソールに変更が表示されるまで数秒かかることがあります。

移行を無効化または有効化する (CLI)

AWS CLI を使用してステージ間の遷移を無効にするには、disable-stage-transition コマンドを実行します。無効にされた遷移を有効にするには、enable-stage-transition コマンドを実行します。

遷移を無効にするには

1. AWS CLI ターミナル (Linux, macOS, or Unix) またはコマンドプロンプト (Windows) を開き、パイプラインの名前、遷移を無効にするステージの名前、遷移のタイプ、そのステージへの遷移を無効にする理由を指定して コマンドを実行します。コンソールを使用する場合とは異なり、ステージに入る (インバウンド) 遷移を無効にするか、すべてのアクションが完了した後にステージから出る (アウトバウンド) 遷移を無効にするかを指定する必要もあります。

   たとえば、Staging という名前のパイプラインで MyFirstPipeline という名前のステージへの遷移を無効にするには、以下のようなコマンドを入力します。

   aws codepipeline disable-stage-transition --pipeline-name MyFirstPipeline --stage-name Staging --transition-type Inbound --reason "My Reason"

   このコマンドは何も返しません。

2. 遷移が無効にされたことを確認するには、CodePipeline コンソールでパイプラインを表示するか、get-pipeline-state コマンドを実行します。詳細については、パイプラインを表示する (コンソール) および パイプラインの詳細と履歴を表示する (CLI) を参照してください。

遷移を有効にするには

1. AWS CLI ターミナル (Linux, macOS, or Unix) またはコマンドプロンプト (Windows) を開き、パイプラインの名前、遷移を無効にするステージの名前、遷移のタイプ、そのステージへの遷移を無効にする理由を指定して コマンドを実行します。

   たとえば、Staging という名前のパイプラインで MyFirstPipeline という名前のステージへの遷移を無効にするには、以下のようなコマンドを入力します。

   aws codepipeline enable-stage-transition --pipeline-name MyFirstPipeline --stage-name Staging  --transition-type Inbound

   このコマンドは何も返しません。

2. 遷移が無効にされたことを確認するには、CodePipeline コンソールでパイプラインを表示するか、get-pipeline-state コマンドを実行します。詳細については、パイプラインを表示する (コンソール) および パイプラインの詳細と履歴を表示する (CLI) を参照してください。