建立影像配方的新版本

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

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

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

1. 創建一個CLI輸入JSON文件

   您可以使用內嵌命令參數為命create-image-recipe令提供所有輸入。但是，生成的命令可能很長。若要簡化指令，您可以改為提供包含所有方JSON案設定的檔案。

   注意

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

   若要將資料值提供為命令列參數，請參照 AWS CLI 指令參考。

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

   • name (字串，必要) — 影像配方的名稱。

   • 描述（字符串）— 圖像配方的描述。

   • parentImage(字串，必要) — 影像配方用來做為自訂影像基礎的影像。該值可以是基本映像ARN或 AMI ID。

     注意

     Linux 範例使用 Image BuilderAMI，而視窗範例使用ARN.

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

   • 元件 (陣列，必要) — 包含ComponentConfiguration物件陣列。至少必須指定一個組建元件：

     注意

     Image Builder 會依照您在方案中指定元件的順序來安裝元件。不過，CIS強化元件永遠會持續執行，以確保基準測試會針對您的輸出影像執行。

     • 組件 ARN（字符串，必需）-組件ARN。

       提示

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

     • 參數 (物件陣列) — 包含ComponentParameter物件陣列。如果需要輸入參數，但未在組件中定義預設值，則必須提供值。如果缺少任何必要參數且未定義預設值，Image Builder 將不會建立配方版本。

       重要

       元件參數為純文字值，且已登入 AWS CloudTrail建議您使用 。 AWS Secrets Manager 或 AWS Systems Manager 參數存儲來存儲您的秘密。如需有關 Secrets Manager 的詳細資訊，請參閱什麼是 Secrets Manager？ 在 AWS Secrets Manager 使用者指南。如需關於 AWS Systems Manager 參數存放區，請參閱 AWS Systems Manager 參數存放區 AWS Systems Manager 使用者指南。

       • name (字串，必要) — 要設定的元件參數名稱。

       • value (字串陣列，必要) — 包含用來設定具名元件參數值的字串陣列。如果為元件定義了預設值，且未提供其他值， AWS TOE 使用預設值。

   • additionalInstanceConfiguration(物件) — 指定組建執行個體的其他設定和啟動指令碼。

     • systemsManagerAgent(物件) — 包含組建執行個體上系統管理員代理程式的設定。

       • uninstallAfterBuild(布林值) — 控制系統管理員代理程式是否在建立新建置映像之前從最終組建映像中移除AMI。如果此選項設為true，則會從最終映像中移除代理程式。如果選項設定為false，則會保留代理程式，以便將其包含在新的中AMI。預設值為 false。

         注意

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

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

         • Image Builder 會自動在組建執行個體上安裝系統管理員代理程式，而該作業系統並未在基本映像上預先安裝代理程式。

     • 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

   下面的例子是指視窗服務器 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 中的語義版本。

2. 建立食譜

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

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

   注意

   • 您必須在JSON檔案路徑的開頭包含file://符號。

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

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

2. 像平常一樣選擇映像操作系統（OS）和操作系統版本。

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

2. 選取磁碟 S3 位置 — 輸入 Amazon S3 中存放磁碟映像的位置。若要瀏覽位置，請選擇 [瀏覽 S3]。

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

一般

1. 為基礎映像指定唯一的「名稱」。如果未輸入值，則基本影像會繼承配方名稱。

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

3. 您也可以輸入基本影像的「描述」。