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

# EC2 起動テンプレートを使用する AMI ディストリビューションの設定
<a name="dist-using-launch-template"></a>

ターゲットアカウントとリージョンでの Image Builder AMI の一貫した起動環境を確保するために、`launchTemplateConfigurations` を使用してディストリビューション設定で Amazon EC2 起動テンプレートを指定できます。`launchTemplateConfigurations` は配布プロセス中に存在する場合、Image Builder は、テンプレートの元の設定とビルドの新しい AMI ID をすべて含む起動テンプレートの新しいバージョンを作成します。起動テンプレートを使用して EC2 インスタンスを起動の詳細については、ターゲットのオペレーティングシステムに応じて、以下のいずれかのリンクを参照してください。
+ [起動テンプレートから Linux インスタンスを起動する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [起動テンプレートから Windows インスタンスを起動する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)

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

## コンソールでの AMI ディストリビューション設定への EC2 起動テンプレートの追加
<a name="dist-using-launch-template-console"></a>

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

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

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

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

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

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

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

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

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

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

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

## から EC2 起動テンプレートを AMI ディストリビューション設定に追加する AWS CLI
<a name="dist-using-launch-template-cli"></a>

このセクションでは、起動テンプレートで配布設定ファイルを構成し、 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"
   }
   ```

1. 

**ディストリビューション設定を作成する**

   の [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html) コマンドを使用して 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 ではディレクトリパスを表すためにバックスプラッシュ (\$1) が使用され、Linux と macOS ではフォーワードスラッシュ (/) が使用されます。

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