建立和更新 AMI 分佈組態

開啟 EC2 Image Builder 主控台，位於 https://console.aws.amazon.com/imagebuilder/。

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

選擇分佈設定面板頂端附近的建立分佈設定。

在映像類型區段中，選擇 Amazon Machine Image (AMI) 輸出類型。

在一般區段中，輸入分佈組態的名稱，以及選用的描述。

在區域設定區段中，針對您要分發 AMI 的每個區域輸入下列詳細資訊：

1. 根據預設，AMI 會分佈到目前的區域 (區域 1)。區域 1 是分佈的來源。區域 1 的某些設定未開啟以供編輯。對於您新增的任何區域，您可以從區域下拉式清單中選擇區域。

   Kms 金鑰可識別 AWS KMS key 用於加密目標區域中影像 EBS 磁碟區的 。請務必注意，這不適用於建置在來源區域 (區域 1) 中帳戶下建立的原始 AMI。在建置的分佈階段執行的加密僅適用於分佈到其他帳戶或區域的映像。

   若要加密在您帳戶來源區域中建立之 AMI 的 EBS 磁碟區，您必須在 主控台的影像配方區塊型設備映射 (儲存 （磁碟區）) 中設定 KMS 金鑰。

   Image Builder 會將 AMI 複製到您為區域指定的目標帳戶。

   先決條件

   若要跨帳戶複製映像，您必須在所有分發目標帳戶中建立EC2ImageBuilderDistributionCrossAccountRole角色，並將 Ec2ImageBuilderCrossAccountDistributionAccess 政策受管政策連接至角色。

   輸出 AMI 名稱是選用的。如果您提供名稱，最終輸出 AMI 名稱會包含 AMI 建置時的附加時間戳記。如果您未指定名稱，Image Builder 會將建置時間戳記附加至配方名稱。這可確保每個組建的唯一 AMI 名稱。

   1. 透過 AMI 共用，您可以授予指定 AWS 委託人從 AMI 啟動執行個體的存取權。如果您展開 AMI 共用區段，您可以輸入下列詳細資訊：

      • 啟動許可 – 如果您想要保持 AMI 的私有，請選取私有，並允許特定 AWS 委託人從私有 AMI 啟動執行個體的存取權。如果您想要將 AMI 設為公有，請選取公有。任何 AWS 委託人都可以從您的公有 AMI 啟動執行個體。

      • 委託人 – 您可以授予下列委託人 AWS 啟動執行個體的存取權：

        • AWS 帳戶 – 授予特定 AWS 帳戶的存取權

        • 組織單位 (OU) – 授予 OU 及其所有子實體的存取權。子實體包括 OUs和 AWS 帳戶。

        • 組織 – 授予您 AWS Organizations及其所有子實體的存取權。子實體包括 OUs和 AWS 帳戶。

          首先，選取主體類型。然後在下拉式清單右側的方塊中，輸入您要授予存取權之 AWS 委託人的 ID。您可以輸入不同類型的多個 IDs。

   2. 您可以展開授權組態區段，將以 建立的授權組態連接到 AWS License Manager 映像建置器映像。授權組態包含以企業協議條款為基礎的授權規則。Image Builder 會自動包含與您的基礎 AMI 相關聯的授權組態。

   3. 您可以展開啟動範本組態區段，指定用於從您建立的 AMI 啟動執行個體的 EC2 啟動範本。

      如果您使用的是 EC2 啟動範本，您可以指示 Image Builder 在建置完成後建立新的啟動範本版本，其中包含最新的 AMI ID。若要更新啟動範本，請設定下列設定：

      • 啟動範本名稱 – 選取您要 Image Builder 更新的啟動範本名稱。

      • 設定預設版本 – 選取此核取方塊，將啟動範本預設版本更新為新版本。

      若要新增另一個啟動範本組態，請選擇新增啟動範本組態。每個區域最多可以有五個啟動範本組態。

   4. 您可以展開 SSM 參數組態區段，以設定 SSM 參數，以存放分佈至目的地區域的映像輸出 AMI ID。您可以選擇性地在 區域中指定分佈帳戶。

      參數名稱 – 輸入參數的名稱。例如 /output/image/param。

      資料類型 – 保留預設值 (AWS EC2 Image)。這可讓 Systems Manager 驗證參數值，以確保其為有效的 AMI ID。

2. 若要新增另一個區域的分佈設定，請選擇新增區域。

完成後，請選擇建立設定。

建立 CLI 輸入 JSON 文件

使用檔案編輯工具建立 JSON 檔案，其中包含下列其中一個範例中顯示的金鑰，以及適用於您環境的值。這些範例會定義哪些 AWS 帳戶 AWS Organizations 或組織單位 OUs) 具有啟動您分發到指定區域的 AMI 的許可。將檔案命名為 create-ami-distribution-configuration.json，以供下一個步驟使用：

範例 1：分發至 AWS 帳戶

此範例會將 AMI 分配到兩個區域，並指定 在每個區域中 AWS 帳戶 具有啟動許可。

{
	"name": "MyExampleAccountDistribution",
	"description": "Copies AMI to eu-west-1, and specifies accounts that can launch instances in each Region.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"amiTags": {
					"KeyName": "Some Value"
				},
				"launchPermission": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-1",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"amiTags": {
					"KeyName": "Some value"
				},
				"launchPermission": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

範例 2：分發至 Organizations 和 OUs

此範例會將 AMI 分配至來源區域，並指定組織和 OU 啟動許可。

{
	"name": "MyExampleAWSOrganizationDistribution",
	"description": "Shares AMI with the Organization and OU",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}",
				"launchPermission": {
					"organizationArns": [
						"arn:aws:organizations::123456789012:organization/o-myorganization123"
					],
					"organizationalUnitArns": [
						"arn:aws:organizations::123456789012:ou/o-123example/ou-1234-myorganizationalunit"
					]
				}
			}
		}
	]
}

範例 3：將輸出 AMI ID 儲存在 SSM 參數中

此範例會將輸出 AMI ID 存放在分佈區域的 AWS Systems Manager 參數存放區參數中。

{
	"name": "SSMParameterOutputAMI",
	"description": "Updates an SSM parameter with the output AMI ID for the distribution.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}"
			},
			"ssmParameterConfigurations": [
				{
					"amiAccountId": "111122223333",
					"parameterName": "/output/image/param",
					"dataType": "aws:ec2:image"
				}
			]
		}
	]
}

使用您建立做為輸入的檔案，執行下列命令。

aws imagebuilder create-distribution-configuration --cli-input-json file://create-ami-distribution-configuration.json

如需詳細資訊，請參閱《 AWS CLI 命令參考create-distribution-configuration》中的 。

開啟 EC2 Image Builder 主控台，位於 https://console.aws.amazon.com/imagebuilder/。

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

若要檢視詳細資訊或更新分佈組態，請選擇組態名稱連結。這會開啟分佈設定的詳細資訊檢視。

若要編輯分佈組態，請從分佈詳細資訊區段的右上角選擇編輯。有些欄位已鎖定，例如分佈組態的名稱，以及顯示為區域 1 的預設區域。如需分佈組態設定的詳細資訊，請參閱 建立 AMI 分佈組態。

完成後，請選擇 Save changes (儲存變更)。

建立 CLI 輸入 JSON 文件

使用檔案編輯工具建立 JSON 檔案，其中包含下列範例中顯示的金鑰，以及適用於您環境的值。此範例使用名為 的檔案update-ami-distribution-configuration.json。

{
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-ami-distribution-configuration.json",
	"description": "Copies AMI to eu-west-2, and specifies accounts that can launch instances in each Region.",
	"distributions": [
	  {
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"launchPermissions": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-2",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"tags": {
					"KeyName": "Some value"
				},
				"launchPermissions": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

使用您建立做為輸入的檔案，執行下列命令。

aws imagebuilder update-distribution-configuration --cli-input-json file://update-ami-distribution-configuration.json

如需詳細資訊，請參閱《 AWS CLI 命令參考update-distribution-configuration》中的 。若要更新分佈組態資源的標籤，請參閱 標籤資源一節。