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

# Image Builder でのパイプラインワークフローの設定
<a name="pipeline-workflows"></a>

イメージワークフローでは、パイプラインが実行するワークフローを必要に応じてカスタマイズしてイメージを構築およびテストできます。定義するワークフローは、Image Builder ワークフローフレームワークのコンテキスト内で実行されます。ワークフローフレームワークを構成するステージの詳細については、「[Image Builder イメージのビルドワークフローとテストワークフローの管理](manage-image-workflows.md)」を参照してください。

ビルドワークフロー  
ビルドワークフローは、ワークフローフレームワークの `Build` 段階で実行されます。パイプラインに指定できるビルドワークフローは 1 つのみです。または、ビルドを完全にスキップして、テスト専用パイプラインを設定することもできます。

テストワークフロー  
テストワークフローはワークフローフレームワークの `Test` 段階で実行されます。最大 10 個のテストワークフローをパイプラインに指定できます。パイプラインのみをビルドしたい場合は、テストを完全にスキップすることもできます。



## テストワークフローのテストグループを定義します。
<a name="pipeline-workflows-test-groups"></a>

テストワークフローはテストグループ内で定義されます。最大 10 個のテストワークフローをパイプラインに実行できます。テストワークフローを特定の順序で実行するか、できるだけ多くのワークフローを同時に実行するかを決定します。実行方法は、テストグループの定義方法によって異なります。以下のシナリオは、テストワークフローを定義するいくつかの方法を示したものです。

**注記**  
コンソールを使用してワークフローを作成する場合は、テストグループを定義する前に、時間をかけてテストワークフローをどのように実行するかを計画することをお勧めします。コンソールでは、テストワークフローとグループを追加または削除できますが、順序を変更することはできません。

**シナリオ 1: 一度に 1 つのテストワークフローを実行する**  
すべてのテストワークフローを 1 つずつ実行するには、それぞれに 1 つのテストワークフローを含むテストグループを 10 個まで設定できます。テストグループは、パイプラインに追加した順に 1 つずつ実行します。これは、テストワークフローが特定の順序で 1 つずつ実行されるようにするための 1 つの方法です。

**シナリオ 2: 複数のテストワークフローを同時に実行する**  
順序は重要ではなく、できるだけ多くのテストワークフローを同時に実行したい場合は、1 つのテストグループを設定し、そのグループに最大数のテストワークフローを設定できます。Image Builder は同時に最大 5 つのテストワークフローを起動し、各テストワークフローが完了すると新しいテストワークフローを開始します。テストワークフローをできるだけ速く実行することが目標であれば、これがその方法の 1 つです。

**シナリオ 3: 混合と組み合わせ**  
同時に実行できるテストワークフローと 1 つずつ実行する必要があるテストワークフローが混在するシナリオでは、この目標を達成するようにテストグループを設定できます。テストグループの設定方法に関する唯一の制限は、パイプラインで実行できるテストワークフローの最大数です

## コンソールでの Image Builder パイプラインのワークフローパラメータの設定
<a name="pipeline-workflow-set-params"></a>

ワークフローパラメータは、ビルドワークフローとテストワークフローで同じように機能します。パイプラインを作成または更新するときは、含めたいビルドワークフローとテストワークフローを選択します。選択したワークフローのワークフロードキュメントでパラメータを定義した場合、Image Builder は **[パラメータ]** パネルにそのパラメータを表示します。パラメータが定義されていないワークフローでは、このパネルは非表示になります。

各パラメータには、ワークフロードキュメントで定義されている以下の属性が表示されます。
+ **[名前]** (編集不可) – パラメータの名前。
+ **型** (編集不可) - パラメータ値のデータ型。
+ **値** – パラメータの値。パラメータ値を編集してパイプラインに設定できます。

## Image Builder がワークフローアクションを実行するために使用する IAM サービスロールを指定します。
<a name="pipeline-workflow-service-role"></a>

イメージワークフローを実行するには、Image Builder にワークフローアクションを実行する権限が必要です。[AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder) サービスリンクロールを指定することも、次のように、サービスアクセス用の独自のカスタムロールを指定することもできます。
+ **コンソール** — パイプラインウィザードの **[ステップ 3: イメージ作成プロセスの定義]** で、**[サービスアクセス]** パネルの **[IAM ロール]** リストから、サービスリンクロールまたは独自のカスタムロールを選択します。
+ **Image Builder API** – [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html) アクションリクエストで、サービスリンクロールまたは独自のカスタムロールを `executionRole` パラメータの値として指定します。

サービスロールの作成方法の詳細については、「 *AWS Identity and Access Management ユーザーガイド*」の[「 AWS サービスにアクセス許可を委任するロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)」を参照してください。