建立新的容器配方版本

若要建立新的容器配方版本：

1. 在容器配方詳細資訊頁面頂端，選擇建立新版本 。系統會將您導向容器配方的建立配方頁面。

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

1. 建立CLI輸入JSON檔案

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

   注意

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

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

   以下是此範例中參數的摘要：

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

     注意

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

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

       提示

       若要使用 範例建立您自己的容器配方，請將範例取代ARNsARNs為您用於配方之元件的 。其中包括每個 的 、 AWS 區域名稱和版本編號。

     • 參數 （物件陣列） – 包含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 會使用預設值。

   • containerType （字串，必要） – 要建立的容器類型。有效值包括 DOCKER。

   • dockerfileTemplateData （字串） – 用來建置映像的 Dockerfile 範本，以內嵌資料 Blob 表示。

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

   • description （string） – 容器配方的描述。

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

   • platformOverride （字串） – 當您使用自訂基礎映像時指定作業系統平台。

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

   • 標籤 （字串映射） – 連接至容器配方的標籤。

   • instanceConfiguration （物件） – 一組選項，可用於設定執行個體以建置和測試容器映像。

     • image （string） – 用作容器建置和測試執行個體基礎映像的 AMI ID。如果您未指定此值，Image Builder 會使用適當的 Amazon ECS最佳化AMI作為基礎映像。

     • blockDeviceMappings （物件陣列） – 定義從 image 參數中AMI指定的 Image Builder 建置執行個體時要連接的區塊裝置。

       • deviceName （字串） – 這些映射適用的裝置。

       • ebs （物件） – 用於管理此映射的 Amazon EBS特定組態。

         • deleteOnTermination （布林值） – 用於設定關聯裝置終止時的刪除。

         • 加密 （布林值） – 用於設定裝置加密。

         • volumeSize （整數） – 用於覆寫裝置的磁碟區大小。

         • volumeType （字串） – 用於覆寫裝置的磁碟區類型。

   • targetRepository （物件，必要） – 如果您的管道的管道分佈組態中沒有指定管道執行的區域 （區域 1），容器映像的目的地儲存庫。

     • repositoryName （字串，必要） – 儲存輸出容器映像的容器儲存庫名稱。此名稱以儲存庫位置為字首。

     • service （字串，必要） – 指定註冊此映像的服務。

   • workingDirectory （字串） – 在建置和測試工作流程期間使用的工作目錄。

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. 建立配方

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

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

   注意

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

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