翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ステージを手動でロールバックする
<a name="stage-rollback-manual"></a>

コンソールまたは CLI を使用して、ステージを手動でロールバックできます。パイプラインは、以前の実行が現在のパイプライン構造バージョンで開始されている場合にのみ、以前の実行にロールバックできます。

「[ステージの自動ロールバックを設定する](stage-rollback-auto.md)」で説明しているように、失敗時に自動的にロールバックするようにステージを設定することもできます。

## ステージを手動でロールバックする (コンソール）
<a name="stage-rollback-console"></a>

コンソールを使用して、ステージをターゲットパイプライン実行に手動でロールバックできます。ステージをロールバックすると、**Rollback** ラベルがコンソールのパイプライン可視化に表示されます。

**ステージを手動でロールバックする (コンソール）**

1. にサインイン AWS マネジメントコンソール し、[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home) で CodePipeline コンソールを開きます。

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

1. **[名前]** で、ロールバックするステージのパイプラインの名前を選択します。  
![CodePipeline でパイプラインの 2 つのステージの例を示す図。](http://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/images/rollback-stage-first.png)

1. ステージで、**[ロールバックを開始]** を選択します。**[次にロールバック:]** ページが表示されます。

1. ステージをロールバックする先のターゲット実行を選択します。
**注記**  
利用可能なターゲットパイプライン実行のリストは、2024 年 2 月 1 日以降の現在のパイプラインバージョンのすべての実行になります。  
![CodePipeline でターゲット実行 ID を選択する例。](http://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/images/rollback-stage-dialog.png)

次の図は、ステージをロールバックした後の新しい実行 ID の例を示しています。

![CodePipeline でステージをロールバックした後のパイプラインの例を示す図。](http://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/images/stage-rolled-back.png)


## ステージを手動でロールバックする (CLI)
<a name="stage-rollback-cli"></a>

を使用してステージ AWS CLI を手動でロールバックするには、 `rollback-stage` コマンドを使用します。

また、「[ステージを手動でロールバックする](#stage-rollback-manual)」で説明しているように、ステージを手動でロールバックすることもできます。

**注記**  
利用可能なターゲットパイプライン実行のリストは、2024 年 2 月 1 日以降の現在のパイプラインバージョンのすべての実行になります。

**ステージを手動でロールバックするには (CLI)**

1. 手動ロールバックの CLI コマンドには、ステージで以前に成功したパイプライン実行の実行 ID が必要です。ターゲットパイプライン実行 ID を指定して取得するには、list-pipeline-executions コマンドでステージの成功した実行を返すフィルターを使用します。ターミナル (Linux、macOS、または Unix) またはコマンドプロンプト (Windows) を開き、 AWS CLI を使用して`list-pipeline-executions`コマンドを実行し、パイプラインの名前とステージで正常に実行するためのフィルターを指定します。この例では、MyFirstPipeline という名前のパイプラインの実行と、`deploys3` という名前のステージで成功した実行が出力に一覧表示されます。

   ```
   aws codepipeline list-pipeline-executions --pipeline-name MyFirstPipeline --filter succeededInStage={stageName=deploys3}
   ```

   出力で、ロールバック用に指定する、以前に成功した実行の実行 ID をコピーします。次のステップで、これをターゲット実行 ID として使用します。

1. ターミナル (Linux、macOS、Unix) またはコマンドプロンプト (Windows) を開きます。次に AWS CLI を使用し、パイプラインの名前、ステージの名前、ロールバック先のターゲット実行を指定して `rollback-stage` コマンドを実行します。例えば、{{MyFirstPipeline}} という名前のパイプラインの Deploy という名前のステージをロールバックするには、次のように指定します。

   ```
   aws codepipeline rollback-stage --pipeline-name MyFirstPipeline --stage-name Deploy --target-pipeline-execution-id bc022580-4193-491b-8923-9728dEXAMPLE 
   ```

   出力は、ロールバックされた新しい実行の実行 ID を返します。これは、指定したターゲット実行のソースリビジョンとパラメータを使用する別の ID です。