View a markdown version of this page

イメージワークフローの作成 - EC2 イメージビルダー

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

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

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

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

新しいビルド、テスト、またはディストリビューションワークフローを作成するには、環境に一致するタブを選択します。

AWS マネジメントコンソール

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

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

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

    注記

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

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

  4. 新しいワークフローの詳細を設定します。フォームの上部にあるワークフロータイプを選択します。ビルドを選択してビルドワークフローを作成するか、テストしてテストワークフローを作成するか、ディストリビューションを選択してディストリビューションワークフローを作成します。ワークフロータイプは API Typeの値 (BUILD、TEST、または ) にマッピングされますDISTRIBUTION。Image Builder は、このオプションに基づいて [テンプレート] リストにデータを入力します。他のすべてのステップは、ビルド、テスト、およびディストリビューションワークフローで同じです。

    General

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

    • [イメージワークフロー名] (必須) — イメージワークフローの名前。新しい名前は アカウント内で一意である必要があります。名前の最大長は 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"
}

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

例: ディストリビューションワークフローを作成する

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

出力:

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