

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

# CodePipeline でパイプライン実行を停止します。
<a name="pipelines-stop"></a>

パイプライン実行がパイプラインを介して開始されると、パイプライン実行は一度に 1 つのステージに入り、ステージ内のすべてのアクション実行の処理中はステージをロックします。これらの進行中のアクションは、パイプラインの実行が停止されたときに、アクションが完了または中止されるように処理する必要があります。

パイプラインの実行を停止する方法は 2 つあります。
+ **Stop and wait**: 進行中のアクションがすべて完了するまで (つまり、アクション`Failed`のステータスが `Succeeded`または になるまで）、実行を AWS CodePipeline 停止します。このオプションは、進行中のアクションを保持します。進行中のアクションが完了するまで、実行は `Stopping` 状態になります。その後、実行は `Stopped` 状態になります。アクションが完了すると、ステージがロック解除します。

  [Stop and wait (停止して待機)] を選択し、実行がまだ `Stopping` 状態にある間に待機するのを止める場合は、[中止] を選択できます。
+ **Stop and abandon**: 進行中のアクションが完了するのを待たずに実行を AWS CodePipeline 停止します。進行中のアクションが中止される間、実行は非常に短い時間 `Stopping` 状態になります。実行が停止すると、アクションの実行が `Abandoned` 状態である間、パイプライン実行は `Stopped` 状態になります。ステージのロックが解除されます。

  `Stopped` 状態のパイプライン実行の場合、実行が停止されたステージ内のアクションを再試行できます。
**警告**  
このオプションを使用すると、タスクが失敗する可能性またはタスクの順序が正しくなくなる可能性があります。

**Topics**
+ [パイプライン実行を停止する (コンソール)](#pipelines-stop-console)
+ [インバウンド実行を停止します (コンソール)。](#pipelines-stop-inbound-console)
+ [パイプライン実行を停止する (CLI)](#pipelines-stop-cli)
+ [インバウンド実行 (CLI) を停止します。](#pipelines-stop-inbound-cli)

## パイプライン実行を停止する (コンソール)
<a name="pipelines-stop-console"></a>

コンソールを使用してパイプラインの実行を停止できます。実行を選択し、パイプラインの実行を停止する方法を選択します。

**注記**  
インバウンド実行であるパイプラインの実行を停止することもできます。インバウンド実行を停止する方法については、[インバウンド実行を停止します (コンソール)。](#pipelines-stop-inbound-console) を参照してください。

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

1. 次のいずれかを行います。
**注記**  
実行を停止する前に、ステージの前でトランジションを無効にすることをお勧めします。このようにすれば、実行が停止したためにステージがロック解除するときに、ステージは後続のパイプライン実行を受け付けません。
   + [**名前**] で、停止する実行を含むパイプラインの名前を選択します。パイプラインの詳細ページで、[**Stop execution (実行の停止)**] を選択します。
   + [**View history (履歴の表示)**] を選択します。履歴ページで、[**Stop execution (実行を停止)**] を選択します。

1. [**Stop execution (実行を停止)**] ページの [**Select execution (実行の選択)**] で、停止する実行を選択します。
**注記**  
実行は、進行中の場合にのみ表示されます。すでに完了している実行は表示されません。  
![\[コンソールで選択されている [停止して待機] オプションを示す画像\]](http://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/images/stop-execution.png)

1. [**Select an action to apply to execution (実行に適用するアクションの選択)**] で、次のいずれかを選択します。
   + 進行中のすべてのアクションが完了するまで実行が停止しないようにするには、[**Stop and wait (停止して待機)**] を選択します。
**注記**  
実行がすでに [**停止**] 状態になっている場合、[Stop and wait (停止して待機)] を選択することはできませんが、[Stop and abandon (停止して中止)] は選択できます。
   + 進行中のアクションが完了するのを待たずに停止するには、[**Stop and abandon (停止して中止)**] を選択します。
**警告**  
このオプションを使用すると、タスクが失敗する可能性またはタスクの順序が正しくなくなる可能性があります。

1. （オプション）コメントを入力します。これらのコメントは、実行ステータスとともに、実行の履歴ページに表示されます。

1. **[停止]** を選択します。
**重要**  
このアクションを元に戻すことはできません。

1. パイプラインの視覚化で実行ステータスを次のように表示します。
   + [Stop and wait (停止して待機)] を選択した場合、実行中のアクションが完了するまで、選択した実行が続行されます。
     + 成功バナーメッセージがコンソールの上部に表示されます。
     + 現在のステージでは、進行中のアクションが `InProgress` 状態で継続されます。アクションが進行中の間、パイプラインの実行は `Stopping` 状態です。

       アクションが完了 (つまり、アクションが失敗または成功) した後、パイプラインの実行は `Stopped` 状態に変更され、アクションは `Failed` または `Succeeded` 状態に変わります。実行の詳細ページでアクションの状態を表示することもできます。実行ステータスは、実行履歴ページまたは実行詳細ページで表示できます。
     + パイプラインの実行が一時的に `Stopping` 状態に変わった後、`Stopped` 状態に変わります。実行ステータスは、実行履歴ページまたは実行詳細ページで表示できます。
   + [Stop and abandon (停止して中止)] を選択した場合、実行は進行中のアクションが完了するまで待機しません。
     + 成功バナーメッセージがコンソールの上部に表示されます。
     + 現在のステージでは、進行中のアクションが `Abandoned` のステータスに変わります 。また、実行の詳細ページでアクションのステータスを表示することもできます。
     + パイプラインの実行が一時的に `Stopping` 状態に変わった後、`Stopped` 状態に変わります。実行ステータスは、実行履歴ページまたは実行詳細ページで表示できます。

   パイプライン実行ステータスは、実行履歴ビューと詳細履歴ビューで表示できます。

## インバウンド実行を停止します (コンソール)。
<a name="pipelines-stop-inbound-console"></a>

コンソールを使用してインバウンドの実行を停止できます。インバウンド実行は、トランジションが無効になっているステージの入力を待っているパイプラインの実行です。トランジションが有効な場合、`InProgress` であるインバウンド実行は引き続きステージを入力し続けます。`Stopped` であるインバウンド実行はステージを入力しません。

**注記**  
インバウンド実行が停止した後は、再試行できません。

インバウンド実行が表示されない場合、無効なステージ移行段階での保留中の実行はありません。

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

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

1. インバウンド実行を停止したいパイプラインの名前を選択し、以下のいずれかの操作を行います。
   + [パイプライン] ビューで、インバウンド実行 ID を選択し、実行を停止することを選択します。
   + パイプラインを選択し、**View history** を選択します。実行履歴で、インバウンド実行 ID を選択し、実行を停止することを選択します。

1. **Stop execution** モーダルで、上記のセクションの手順に従って実行 ID を選択し、停止方法を指定します。

   **get-pipeline-state** のコマンドを実行して、インバウンド実行のステータスを表示します。

## パイプライン実行を停止する (CLI)
<a name="pipelines-stop-cli"></a>

を使用してパイプライン AWS CLI を手動で停止するには、次のパラメータを指定して **stop-pipeline-execution** コマンドを使用します。
+ 実行 ID (必須)
+ コメント (オプション)
+ パイプライン名 (必須)
+ 中止フラグ（オプション、デフォルトは false）

コマンド形式:

```
aws codepipeline stop-pipeline-execution --pipeline-name Pipeline_Name –-pipeline-execution-id Execution_ID [--abandon | --no-abandon] [--reason STOP_EXECUTION_REASON]
```

1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。

1. パイプライン実行を停止するには、次のいずれかを選択します。
   + 進行中のすべてのアクションが完了するまで実行が停止しないようにするには、[Stop and wait (停止して待機)] を選択します。これを行うには、**no-abandon** パラメータを含めます。パラメータを指定しない場合、コマンドのデフォルトは [Stop and wait (停止して待機)] になります。 AWS CLI を使用して **stop-pipeline-execution** コマンドを実行し、パイプラインの名前と実行 ID を指定します。たとえば、指定された（停止）と「待機）を用いて、*MyFirstPipeline* と名付けられたパイプラインを停止するには:

     ```
     aws codepipeline stop-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id d-EXAMPLE --no-abandon
     ```

     たとえば、*MyFirstPipeline* という名前のパイプラインを停止し、（停止）と（待機）オプションをデフォルトにし、コメントを含めるようにするには

     ```
     aws codepipeline stop-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id d-EXAMPLE --reason "Stopping execution after the build action is done"
     ```
**注記**  
実行がすでに [**停止**] 状態になっている場合、[Stop and wait (停止して待機)] を選択することはできません。実行がすでに [**停止**] 状態になっている場合、[Stop and abandon (停止して中止)] を選択することはできません。
   + 進行中のアクションが完了するのを待たずに停止するには、[Stop and abandon (停止して中止)] を選択します。**abandon** パラメータを指定します。 AWS CLI を使用して **stop-pipeline-execution** コマンドを実行し、パイプラインの名前と実行 ID を指定します。

     たとえば、*MyFirstPipeline* という名前のパイプラインを停止し、(中止)オプションを指定し、コメントを含めるようにするには

     ```
     aws codepipeline stop-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id d-EXAMPLE --abandon --reason "Stopping execution for a bug fix"
     ```

## インバウンド実行 (CLI) を停止します。
<a name="pipelines-stop-inbound-cli"></a>

CLI を使用して、インバウンドの実行を停止できます。インバウンド実行は、トランジションが無効になっているステージの入力を待っているパイプライン実行です。トランジションが有効な場合、`InProgress` であるインバウンド実行は引き続きステージを入力し続けます。`Stopped` であるインバウンド実行はステージを入力しません。

**注記**  
インバウンド実行が停止した後は、再試行できません。

インバウンド実行が表示されない場合、無効なステージ移行段階での保留中の実行はありません。

を使用してインバウンド実行 AWS CLI を手動で停止するには、次のパラメータを指定して **stop-pipeline-execution** コマンドを使用します。
+ インバウンドの実行 ID (必須)
+ コメント (オプション)
+ パイプライン名 (必須)
+ 中止フラグ（オプション、デフォルトは false）

コマンド形式:

```
aws codepipeline stop-pipeline-execution --pipeline-name Pipeline_Name –-pipeline-execution-id Inbound_Execution_ID [--abandon | --no-abandon] [--reason STOP_EXECUTION_REASON]
```

上記の手順に従って、コマンドを入力し、停止方法を指定します。

**get-pipeline-state** コマンドを使用して、インバウンド実行のステータスを表示します。