イメージワークフローの作成

イメージワークフローを作成すると、イメージの作成プロセスをより細かく制御できます。Image Builder がイメージをビルドするときに実行するワークフローと、イメージをテストするときに実行するワークフローを指定できます。また、カスタマーマネージドキーを指定してワークフローリソースを暗号化することもできます。ワークフローリソースの暗号化の詳細については、「Image Builder での暗号化とキー管理」を参照してください。

イメージの作成には、ビルドステージのワークフローを 1 つと、テストステージのワークフローを 1 つ以上指定できます。必要に応じて、ビルドステージやテストステージを完全にスキップすることもできます。ワークフローが使用するYAML定義ドキュメントで、ワークフローが実行するアクションを設定します。YAML ドキュメントの構文の詳細については、「」を参照してくださいYAML ワークフロードキュメントを作成する。

ビルドワークフローまたはテストワークフローを新しく作成する手順については、使用する環境に合ったタブを選択してください。

AWS Management Console

以下のプロセスを使用して、Image Builder コンソールで新しいワークフローを作成できます。

1. で EC2 Image Builder コンソールを開きますhttps://console.aws.amazon.com/imagebuilder/。

2. ナビゲーションペインから [イメージワークフロー] を選択します。これにより、アカウントが所有している、またはアクセスできるイメージワークフローのリストが表示されます。

   注記

   Image Builder がデフォルトのワークフローに使用する Amazon マネージドワークフローリソースは、常にリストに表示されます。これらのワークフローの詳細を表示するには、[ワークフロー] リンクを選択します。

3. 新しいワークフローを作成するには、[イメージワークフローを作成] を選します。これにより、[イメージワークフローを作成] ページが表示されます。

4. 新しいワークフローの詳細を設定します。ビルドワークフローを作成するには、フォームの上部にある [ビルド] オプションを選択します。テストワークフローを作成するには、フォームの上部にある [テスト] オプションを選択します。Image Builder は、このオプションに基づいて [テンプレート] リストにデータを入力します。ビルドワークフローおよびテストワークフローのその他のステップは、すべて同じです。

   全般

   一般セクションには、名前や説明など、ワークフローリソースに適用される設定が含まれます。一般設定には以下が含まれます。

   • [イメージワークフロー名] (必須) — イメージワークフローの名前。新しい名前は アカウント内で一意である必要があります。名前の最大長は 128 文字です。使用可能な文字は、文字、数字、スペース、-、および _ です。

   • [バージョン] (必須) — 作成するワークフローリソースのセマンティックバージョン (major.minor.patch)。

   • [説明] (オプション) — オプションでワークフローの説明を追加します。

   • KMS キー (オプション) – ワークフローリソースをカスタマーマネージドキーで暗号化できます。詳細については、「カスタマーマネージドキーを使用してイメージワークフローを暗号化する」を参照してください。

   定義ドキュメント

   YAML ワークフロードキュメントには、ワークフローのすべての設定が含まれています。

   使用を開始する

   • Image Builder のデフォルトテンプレートをワークフローのベースラインとして開始するには、[テンプレートから開始] オプションを選択します。このオプションはデフォルト選択。[テンプレート] リストから使用するテンプレートを選択すると、選択したテンプレートのデフォルト設定が新しいワークフロードキュメントの [コンテンツ] にコピーされ、そこで変更を加えることができます。

   • ワークフロードキュメントを最初から定義するには、[ゼロから開始] オプションを選択します。これにより、ドキュメント形式の重要な部分の簡単な概要が [コンテンツ] に入力され、作業を開始しやすくなります。

   コンテンツパネルには、YAMLドキュメントの警告またはエラーを示すステータスバーが下部にあります。YAML ワークフロードキュメントの作成方法の詳細については、「」を参照してくださいYAML ワークフロードキュメントを作成する。

5. ワークフローが完了したら、または進行状況を保存して後で戻りたい場合は、[ワークフローを作成] を選択します。

AWS CLI

で create-workflow コマンドを実行する前に AWS CLI、ワークフローのすべての設定を含むYAMLドキュメントを作成する必要があります。詳細については、「YAML ワークフロードキュメントを作成する」を参照してください。

次の例は、create-workflow AWS CLI コマンドを使用してビルドワークフローを作成する方法を示しています。--data パラメータは、作成するワークフローのビルド設定を含むYAMLドキュメントを指します。

例: ワークフローの作成

aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml

出力:

{
"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

次の例は、create-workflow AWS CLI コマンドを使用してテストワークフローを作成する方法を示しています。--data パラメータは、作成するワークフローのビルド設定を含むYAMLドキュメントを指します。

例: テストワークフローの作成

aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml

出力:

{
"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}