Image Builder でクロスアカウント AMI ディストリビューションのセットアップ

複数のアカウントに分散されている Image Builder AMI を使用するには、宛先アカウントの所有者が自分の EC2ImageBuilderDistributionCrossAccountRole というアカウントで新しい IAM ロールを作成する必要があります。

アカウント間の配信を有効にするには、「Ec2ImageBuilderCrossAccountDistributionAccess ポリシー」をロールにアタッチする必要があります。マネージドポリシーの詳細については、AWS Identity and Access Management IAM ユーザーガイドの「マネージドポリシーとインラインポリシー」を参照してください。

ソースアカウント ID が、宛先アカウントの IAM ロールにアタッチされた信頼ポリシーに追加されていることを確認します。次の例は、送信元アカウントのアカウント ID を指定する送信先アカウントの信頼ポリシーを示しています。

信頼ポリシーの詳細については、AWS Identity and Access Management User Guide の Resource-Based Policies を参照してください。

配布する AMI が暗号化されている場合、宛先アカウントの所有者は、KMS キーを使用できるように、アカウントで EC2ImageBuilderDistributionCrossAccountRole に次のインラインポリシーを追加する必要があります。Principal セクションにはアカウント番号が含まれています。これにより、Image Builder は、 AWS KMS を使用して AMI を各リージョンの適切なキーで暗号化および復号するときに、ユーザーに代わって動作できるようになります。

インラインポリシーの詳細については、AWS Identity and Access Management ユーザーガイドの「インラインポリシー」を参照してください。

launchTemplateConfigurations を使用して Amazon EC2 起動テンプレートを指定する場合は、各宛先アカウントの EC2ImageBuilderDistributionCrossAccountRole に次のポリシーを追加する必要もあります。

AWS Systems Manager Parameter Store パラメータを使用してディストリビューションアカウントとリージョンの出力 AMI の AMI ID を保存する場合は、各送信先アカウントの EC2ImageBuilderDistributionCrossAccountRole に次のポリシーを追加する必要があります。

https://console.aws.amazon.com/imagebuilder/ で、EC2 Image Builder コンソールを開きます。

ナビゲーションペインから配信設定を選択します。これにより、アカウントで作成されたディストリビューション設定のリストが表示されます。

ディストリビューション設定ページの上部で、ディストリビューション設定を作成を選択します。これにより、ディストリビューション設定の作成 ページが表示されます。

イメージタイプ セクションで、出力タイプ として Amazon マシンイメージ (AMI) を選択します。これはデフォルトの設定です。

全般セクションに、作成する配布設定リソースの名前を入力します（必須）。

リージョン設定で、選択したリージョンのターゲットアカウントに AMI を配布したい 12 桁のアカウント ID を入力し、Enter を押す。これにより正しい形式が確認され、入力したアカウント ID がボックスの下に表示されます。このプロセスを繰り返して、さらにアカウントを追加します。

入力したアカウントを削除するには、アカウント ID の右に表示される X を選択します。

各リージョンの出力 AMI 名を入力します。

必要な追加設定を続けて指定し、設定の作成を選択して新しい配布設定リソースを作成します。

ディストリビューション設定ファイルを設定する

で create-image コマンドを使用して、別のアカウントに配布される Image Builder AMI AWS CLI を作成する前に、AmiDistributionConfiguration設定でターゲットアカウント IDs を指定する DistributionConfiguration JSON 構造を作成する必要があります。ソースリージョンで、少なくとも 1 つのAmiDistributionConfigurationエントリを指定する必要があります。

次の create-distribution-configuration.json というサンプルファイルは、ソースリージョンでのクロスアカウントイメージ配信の設定を示しています。

{
	"name": "cross-account-distribution-example",
	"description": "Cross Account Distribution Configuration Example",
	"distributions": [
		{
			"amiDistributionConfiguration": {
				"targetAccountIds": ["123456789012", "987654321098"],
				"name": "Name {{ imagebuilder:buildDate }}", 
				"description": "ImageCopy Ami Copy Configuration"
			}, 
			"region": "us-west-2"
		}
	]
}

ディストリビューション設定を作成する

の create-distribution-configuration コマンドを使用して Image Builder ディストリビューション設定リソースを作成するには AWS CLI、 コマンドで次のパラメータを指定します。

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