EC2 起動テンプレートを使用する AMI ディストリビューションの設定 - EC2 イメージビルダー

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

EC2 起動テンプレートを使用する AMI ディストリビューションの設定

ターゲットアカウントとリージョンでの Image Builder AMI の一貫した起動環境を確保するために、launchTemplateConfigurations を使用してディストリビューション設定で Amazon EC2 起動テンプレートを指定できます。launchTemplateConfigurations は配布プロセス中に存在する場合、Image Builder は、テンプレートの元の設定とビルドの新しい AMI ID をすべて含む起動テンプレートの新しいバージョンを作成します。起動テンプレートを使用して EC2 インスタンスを起動の詳細については、ターゲットのオペレーティングシステムに応じて、以下のいずれかのリンクを参照してください。

注記

Windows 高速起動を有効にする起動テンプレートをイメージに含める場合は、起動テンプレートに次のタグを含める必要があります。これにより、Image Builder がユーザーに代わって Windows 高速起動を有効にできます。

CreatedBy: EC2 Image Builder

コンソールでの AMI ディストリビューション設定への EC2 起動テンプレートの追加

出力 AMI に起動テンプレートを提供するには、コンソールで次の手順に従います。

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

  2. ナビゲーションペインから配信設定を選択します。これにより、アカウントで作成されたディストリビューション設定のリストが表示されます。

  3. ディストリビューション設定ページの上部で、ディストリビューション設定を作成を選択します。ディストリビューション設定の作成ページが開きます。

  4. イメージタイプセクションで、Amazon マシンイメージ (AMI) 出力タイプを選択します。これはデフォルトの設定です。

  5. 全般セクションに、作成する配布設定リソースの名前を入力します(必須)。

  6. リージョン設定で、リストから EC2 起動テンプレートの名前を選択します。アカウントに起動テンプレートがない場合は、Create new Launch template を選択すると、EC2 ダッシュボード起動テンプレートが開きます。

    デフォルトバージョンを設定チェックボックスを選択して、起動テンプレートのデフォルトバージョンを、Image Builder が出力 AMI で作成する新しいバージョンに更新します。

    選択したリージョンに別の起動テンプレートを追加するには、起動テンプレート設定を追加を選択します。

    起動テンプレートを削除するには、削除を選択します。

  7. 必要な追加設定を続けて指定し、設定の作成を選択して新しい配布設定リソースを作成します。

から EC2 起動テンプレートを AMI ディストリビューション設定に追加する AWS CLI

このセクションでは、起動テンプレートで配布設定ファイルを構成し、 AWS CLI の create-image コマンドを使用して Image Builder AMI とそれを使用する起動テンプレートの新バージョンをビルドして配布する方法について説明します。

  1. ディストリビューション設定ファイルを設定する

    起動テンプレートを使用して Image Builder AMI を作成する前に、 を使用して AWS CLI、launchTemplateConfigurations設定を指定するディストリビューション設定 JSON 構造を作成する必要があります。ソースリージョンで、少なくとも 1 つの launchTemplateConfigurations エントリを指定する必要があります。

    次の create-distribution-config-launch-template.json というサンプルファイルは、ソースリージョンでの起動テンプレート設定で考えられるいくつかのシナリオを示しています。

    { "name": "NewDistributionConfiguration", "description": "This is just a test", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}", "description": "description" }, "launchTemplateConfigurations": [ { "launchTemplateId": "lt-0a1bcde2fgh34567", "accountId": "935302948087", "setDefaultVersion": true }, { "launchTemplateId": "lt-0aaa1bcde2ff3456" }, { "launchTemplateId": "lt-12345678901234567", "accountId": "123456789012" } ] } ], "clientToken": "clientToken1" }
  2. ディストリビューション設定を作成する

    create-distribution-configuration コマンドを使用して Image Builder ディストリビューション設定リソースを作成するには AWS CLI、 コマンドで次のパラメータを指定します。

    • ポリシーの名前を --name パラメータに入力します。

    • --cli-input-json パラメータで作成したディストリビューション設定 JSON ファイルを添付します。

    aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
    注記
    • JSON ファイルパスの先頭にfile://ノテーションを含める必要があります。

    • JSON ファイルのパスは、コマンドを実行するベースオペレーティングシステムに適した規則に従う必要があります。例えば、Windows ではディレクトリパスを表すためにバックスプラッシュ (\) が使用され、Linux と macOS ではフォーワードスラッシュ (/) が使用されます。

また、--distributions パラメータを使用して、コマンドで直接 JSON を指定することもできます。