翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 に起動テンプレートを提供するには、コンソールで次の手順に従います。
-
https://console.aws.amazon.com/imagebuilder/
で、EC2 Image Builder コンソールを開きます。 -
ナビゲーションペインから配信設定を選択します。これにより、アカウントで作成されたディストリビューション設定のリストが表示されます。
-
ディストリビューション設定ページの上部で、ディストリビューション設定を作成を選択します。ディストリビューション設定の作成ページが開きます。
-
イメージタイプセクションで、Amazon マシンイメージ (AMI) 出力タイプを選択します。これはデフォルトの設定です。
-
全般セクションに、作成する配布設定リソースの名前を入力します(必須)。
-
リージョン設定で、リストから EC2 起動テンプレートの名前を選択します。アカウントに起動テンプレートがない場合は、Create new Launch template を選択すると、EC2 ダッシュボードに起動テンプレートが開きます。
デフォルトバージョンを設定チェックボックスを選択して、起動テンプレートのデフォルトバージョンを、Image Builder が出力 AMI で作成する新しいバージョンに更新します。
選択したリージョンに別の起動テンプレートを追加するには、起動テンプレート設定を追加を選択します。
起動テンプレートを削除するには、削除を選択します。
-
必要な追加設定を続けて指定し、設定の作成を選択して新しい配布設定リソースを作成します。
から EC2 起動テンプレートを AMI ディストリビューション設定に追加する AWS CLI
このセクションでは、起動テンプレートで配布設定ファイルを構成し、 AWS CLI の create-image コマンドを使用して Image Builder AMI とそれを使用する起動テンプレートの新バージョンをビルドして配布する方法について説明します。
-
ディストリビューション設定ファイルを設定する
起動テンプレートを使用して 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" }
-
ディストリビューション設定を作成する
の 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 を指定することもできます。