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

若要協助確保 Image Builder AMI 在目標帳戶和區域中的一致啟動體驗，您可以使用 在您的分佈設定中指定 Amazon EC2 啟動範本launchTemplateConfigurations。在分佈過程中launchTemplateConfigurations出現 時，Image Builder 會建立新的啟動範本版本，其中包含範本的所有原始設定，以及建置的新 AMI ID。如需使用啟動範本啟動 EC2 執行個體的詳細資訊，請參閱下列其中一個連結，視您的目標作業系統而定。

• 從啟動範本啟動 Linux 執行個體

• 從啟動範本啟動 Windows 執行個體

注意

當您在映像中包含啟動範本以啟用 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/。

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

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

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

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

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

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

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

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

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

從 將 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"
   }

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。