建立新的映像配方版本

若要建立新的映像配方版本：

1. 在配方詳細資訊頁面頂端，選擇建立新版本。這會帶您前往建立映像配方頁面。

2. 若要建立新版本，請進行變更，然後選擇建立配方。

   您的最終映像最多可包含來自 AWS Marketplace 映像產品和元件的四個產品代碼。如果您選取的基礎映像和元件包含四個以上的產品代碼，Image Builder 會在您嘗試建立配方時傳回錯誤。

1. 建立 CLI 輸入 JSON 文件

   您可以使用內嵌create-image-recipe命令參數提供命令的所有輸入。不過，產生的命令可能相當長。若要簡化命令，您可以改為提供包含所有配方設定的 JSON 檔案。

   注意

   JSON 檔案中資料值的命名慣例遵循為 Image Builder API 操作請求參數指定的模式。若要檢閱 API 操作請求參數，請參閱 EC2 Image Builder API 參考中的 CreateImageRecipe 命令。

   若要提供資料值做為命令列參數，請參閱 AWS CLI 命令參考中指定的參數名稱。

   以下是這些範例指定的參數摘要：

   • name （字串，必要） – 映像配方的名稱。

   • description (string) – 映像配方的描述。

   • parentImage （字串，必要） – 影像配方用作自訂影像基礎的影像。此值可以是基本映像 ARN 或 AMI ID。

     注意

     Linux 和 macOS 範例使用 Image Builder AMI，而 Windows 範例使用 ARN。

   • semanticVersion （字串，必要） – 影像配方的語意版本，以下列格式表示，每個位置都有數值來表示特定版本：<major>.<minor>.<patch>。例如，值可能是 1.0.0。若要進一步了解 Image Builder 資源的語意版本控制，請參閱Image Builder 中的語意版本控制。

   • 元件 （陣列、必要） – 包含ComponentConfiguration物件陣列。必須指定至少一個建置元件：

     注意

     Image Builder 會依您在配方中指定的順序安裝元件。不過，CIS 強化元件一律會最後執行，以確保基準測試針對您的輸出映像執行。

     • componentARN （字串，必要） – 元件 ARN。

       提示

       若要使用其中一個範例來建立自己的映像配方，您必須將範例 ARNs 取代為您配方所使用的元件 ARNs。

     • 參數 （物件陣列） – 包含ComponentParameter物件陣列。如果需要輸入參數，但元件中沒有定義的預設值，則必須提供值。如果缺少任何必要的參數，且未定義預設值，Image Builder 不會建立配方版本。

       重要

       元件參數是純文字值，並會登入 AWS CloudTrail。建議您使用 AWS Secrets Manager 或 AWS Systems Manager 參數存放區來存放秘密。如需 Secrets Manager 的詳細資訊，請參閱AWS Secrets Manager 《 使用者指南》中的什麼是 Secrets Manager？。如需 AWS Systems Manager 參數存放區的詳細資訊，請參閱AWS Systems Manager 《 使用者指南》中的AWS Systems Manager 參數存放區。

       • name （字串，必要） – 要設定的元件參數名稱。

       • value （字串陣列，必要） – 包含字串陣列，可設定具名元件參數的值。如果已為元件定義預設值，且未提供其他值， AWS TOE 會使用預設值。

   • additionalInstanceConfiguration （物件） – 為您的建置執行個體指定其他設定和啟動指令碼。

     • systemsManagerAgent （物件） – 包含建置執行個體上 Systems Manager 代理程式的設定。

       • uninstallAfterBuild （布林值） – 在建立新的 AMI 之前，控制 Systems Manager 代理程式是否從最終建置映像中移除。如果此選項設定為 true，則代理程式會從最終映像中移除。如果 選項設定為 false，則代理程式會保留在 中，使其包含在新的 AMI 中。預設值為 false。

         注意

         如果uninstallAfterBuild屬性不包含在 JSON 檔案中，且下列條件為 true，則 Image Builder 會從最終映像中移除 Systems Manager 代理程式，使其無法在 AMI 中使用：

         • userDataOverride 為空或已從 JSON 檔案省略。

         • Image Builder 會自動將 Systems Manager 代理程式安裝在未於基礎映像預先安裝代理程式的作業系統建置執行個體上。

     • userDataOverride （字串） – 提供命令或命令指令碼，在您啟動建置執行個體時執行。

       注意

       使用者資料一律為 Base 64 編碼格式。例如，下列命令編碼為 IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==：

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       Linux 範例使用此編碼值。

   Linux

   下列範例中的基礎映像 (parentImage 屬性） 是 AMI。使用 AMI 時，您必須擁有 AMI 的存取權，且 AMI 必須位於來源區域 （映像建置器執行命令的相同區域）。將檔案儲存為 create-image-recipe.json，並在 create-image-recipe命令中使用它。

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   下列範例參考最新版的 Windows Server 2016 英文完整基本映像。此範例中的 ARN 會根據您指定的語意版本篩選條件，參考 SKU 中的最新影像：arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x。

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   注意

   若要進一步了解 Image Builder 資源的語意版本控制，請參閱Image Builder 中的語意版本控制。

   macOS

   下列範例中的基礎映像 (parentImage 屬性） 是 AMI。使用 AMI 時，您必須擁有 AMI 的存取權，且 AMI 必須位於來源區域 （映像建置器執行命令的相同區域）。將檔案儲存為 create-image-recipe.json，並在 create-image-recipe命令中使用它。

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

2. 建立配方

   使用下列命令來建立配方。在 --cli-input-json 參數中提供您在上一個步驟中建立的 JSON 檔案名稱：

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json

   注意

   • 您必須在 JSON 檔案路徑的開頭包括 file:// 標記。

   • JSON 檔案的路徑應遵循執行命令之基礎作業系統的適當慣例。例如，Windows 使用反斜線 (\) 來參考目錄路徑，而 Linux 和 macOS 則使用正斜線 (/)。

   您的最終映像最多可包含 AWS Marketplace 來自映像產品和元件的四個產品代碼。如果您選取的基礎映像和元件包含四個以上的產品代碼，Image Builder 會在執行 create-image-recipe命令時傳回錯誤。

1. 在基本映像的選取映像區段中，選取匯入基本映像選項。

2. 像往常一樣選擇映像作業系統 (OS) 和作業系統版本。

1. 來源 – 可以是 S3 儲存貯體或 EBS 快照。

2. 選取磁碟的 S3 位置 – 在 Amazon S3 中輸入儲存磁碟映像的位置。若要瀏覽位置，請選擇瀏覽 S3。

3. 若要新增磁碟容器，請選擇新增磁碟容器。

一般

1. 指定基礎映像的唯一名稱。如果您未輸入值，基礎映像會繼承配方名稱。

2. 指定基礎映像的版本。使用下列格式：<major>.<minor>.<patch>。如果您未輸入值，基礎映像會繼承配方版本。

3. 您也可以輸入基本映像的描述。