本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 EC2 啟動範本設定 AMI 分佈
指定 AMI 啟動範本

若要協助確保 Image Builder AMI 在目標帳戶和區域中的啟動體驗一致，您可以使用 在分發設定中指定 Amazon EC2 啟動範本`launchTemplateConfigurations`。在分發過程中`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 Fast Launch 時，啟動範本必須包含下列標籤，以便 Image Builder 可以代表您啟用 Windows Fast Launch。  
`CreatedBy: EC2 Image Builder`

## 從主控台將 EC2 啟動範本新增至 AMI 分佈設定


若要使用輸出 AMI 提供啟動範本，請遵循主控台中的下列步驟：

1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 從導覽窗格中選擇**分佈設定**。這會顯示在您帳戶下建立的分佈設定清單。

1. 在**分佈設定**頁面頂端，選擇**建立分佈設定**。這會開啟**建立分佈設定**頁面。

1. 在**映像類型**區段中，選擇 **Amazon Machine Image (AMI)** **輸出類型**。這是預設設定。

1. 在**一般**區段中，輸入您要建立的分佈設定資源**名稱** (*必要*)。

1. 在**區域設定**區段中，從清單中選擇 EC2 啟動範本的名稱。如果您的帳戶中沒有啟動範本，請選擇**建立新的啟動範本**，這會在 **EC2 儀表板**中開啟**啟動範本**。

   選取**設定預設版本**核取方塊，將啟動範本預設版本更新為 Image Builder 使用輸出 AMI 建立的新版本。

   若要將另一個啟動範本新增至選取的區域，請選擇**新增啟動範本組態**。

   若要移除啟動範本，請選擇**移除**。

1. 繼續指定您需要的任何其他設定，然後選擇**建立設定**以建立新的分佈設定資源。

## 從 將 EC2 啟動範本新增至 AMI 分佈設定 AWS CLI


本節說明如何使用啟動範本設定分佈設定檔案，並使用 AWS CLI 中的 **create-image**命令來建置和分佈 Image Builder AMI 和使用它的啟動範本新版本。

1. 

**設定分佈設定檔案**

   您必須先 AWS CLI建立指定`launchTemplateConfigurations`設定的分佈組態 JSON 結構，才能使用啟動範本建立映像建置器 AMI。您必須在來源區域中指定至少一個`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。*