建立新的映像配方版本

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

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

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

   您的最終映像最多可包含 AWS Marketplace 來自映像產品和元件的九個產品代碼。如果您的基礎映像和元件超過此限制，Image Builder 會在配方建立期間傳回錯誤。

1. 建立 CLI 輸入 JSON 文件

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

   注意

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

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

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

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

   • description （字串） – 映像配方的描述。

   • parentImage （字串，必要） – 映像配方用作自訂映像基礎的映像。您可以使用下列其中一個選項來指定父系映像：

     • AMI ID – 當您有要自訂的特定 AMI （例如 ami-1234567890abcdef1) 時，請使用 。由於 AMI ID 是靜態的，我們建議您在希望配方自動挑選較新的基礎映像時，改為使用映像建置器映像 ARN 或 SSM 參數。

     • 映像建置器映像資源 ARN – 當您想要建置在映像建置器映像之上時使用。這包括 Image Builder 為最熱門作業系統提供的 Amazon 受管映像，以及您先前建立的映像。使用語意版本指定映像 ARN，或使用版本萬用字元一律取得最新版本。

     • AWS Systems Manager (SSM) 參數存放區參數 – 當您希望配方自動挑選新的 AMI IDs 而不建立新的配方版本時使用。使用 為參數加上字首ssm:，後面接著參數名稱或 ARN。這非常適合應一律使用最新 Amazon Linux 或 Windows 基礎映像的管道。

     • AWS Marketplace 產品 ID – 當您在 中訂閱 AMI 產品 AWS Marketplace 並想要進一步自訂產品時，請使用 。

     注意

     • 當您使用解析為 AMI 的 AMI ID 或 SSM 參數時，您必須擁有帳戶中該 AMI 的存取權。AMI 也必須存在於映像建置器執行建置的相同區域中。

     • Linux 和 macOS 範例會指定 AMI ID，而 Windows 範例會使用映像建置器映像 ARN。

   • semanticVersion （字串，必要） – 輸入您要建立的版本編號，格式為 <major>.<minor>.<patch>。Image Builder 支援配方的自動版本增量，可讓您在配方版本中使用萬用字元模式。當您使用萬用字元版本建立配方時1.0.x，Image Builder 會自動遞增版本 （例如 1.0.1、1.0.2、 1.0.3等）。這不需要手動追蹤和增加配方版本。若要進一步了解 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 的詳細資訊，請參閱什麼是 Secrets Manager？ AWS Secrets Manager 《 使用者指南》中的 。如需 AWS Systems Manager 參數存放區的詳細資訊，請參閱AWS Systems Manager 《 使用者指南》中的AWS Systems Manager 參數存放區。

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

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

   • amiWatermarks （字串陣列，選用） – 要連接至從此配方建置之輸出 AMIs 的浮水印名稱清單。浮水印是譜系標記，可協助您追蹤影像的歷史記錄。指定 1 到 5 個名稱。每個名稱必須是 3 到 128 個字元，可包含字母、數字、空格和下列特殊字元：( ) [ ] . / - ' @ _。如需詳細資訊，請參閱使用浮水印追蹤 AMI 歷程。

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

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

       注意

       Windows 配方不支援 systemsManagerAgent組態。如果您將其包含在 Windows 父系映像中，請求會失敗。

       • 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-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   下列範例參考最新版的 Windows Server 2016 英文完整基礎映像。此範例中的 ARN 會根據您指定的語意版本篩選條件參考最新的映像：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:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333: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-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   範例：不含元件的配方

   您可以建立配方，而不需要任何元件來測試現有的 AMIs或僅限分佈的工作流程。下列範例顯示使用現有 AMI 而不套用任何其他元件的配方：

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

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 來自映像產品和元件的九個產品代碼。如果您的基礎映像和元件在執行 create-image-recipe命令時超過此限制，Image Builder 會在配方建立期間傳回錯誤。

   命令會傳回新映像配方的 ARN，如下列範例輸出所示。

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1"
   }

3. 驗證您的配方

   若要確認 Image Builder 如預期建立您的配方，請使用上一個步驟傳回的 ARN 執行 get-image-recipe命令。

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

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

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

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

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

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

一般

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

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

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