EC2 Image Builder でイメージパイプラインワークフローを設定する

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

ビルドワークフロー

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

テストワークフロー

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

テストワークフローのテストグループを定義します。

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

注記

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

シナリオ 1: 一度に 1 つのテストワークフローを実行する

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

シナリオ 2: 複数のテストワークフローを同時に実行する

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

シナリオ 3: 混合と組み合わせ

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

コンソールから Image Builder パイプラインでワークフローパラメータを設定する

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

各パラメータには、ワークフロードキュメントで定義されている以下の属性が表示されます。

• [名前] (編集不可) – パラメータの名前。

• 型 (編集不可) - パラメータ値のデータ型。

• 値 – パラメータの値。パラメータ値を編集してパイプラインに設定できます。

Image Builder がワークフローアクションを実行するために使用する IAM サービスロールを指定します。

サービスアクセス

イメージワークフローを実行するには、Image Builder にワークフローアクションを実行する権限が必要です。AWSServiceRoleForImageBuilder サービスリンクロールを指定することも、次のように、サービスアクセス用の独自のカスタムロールを指定することもできます。

• コンソール — パイプラインウィザードの [ステップ 3: イメージ作成プロセスの定義] で、[サービスアクセス] パネルの [IAM ロール] リストから、サービスリンクロールまたは独自のカスタムロールを選択します。

• Image Builder API – CreateImageアクションリクエストで、 executionRoleパラメータの値としてサービスにリンクされたロールまたは独自のカスタムロールを指定します。

サービスロールの作成方法の詳細については、「 ユーザーガイド」の「 AWS サービスにアクセス許可を委任するロールの作成AWS Identity and Access Management 」を参照してください。