Richten Sie die kontoübergreifende AMI-Verteilung mit Image Builder ein

Um Image Builder-AMIs zu verwenden, die auf mehrere Konten verteilt sind, muss der Besitzer des Zielkontos in seinem Konto eine neue IAM-Rolle mit dem Namen erstellen. EC2ImageBuilderDistributionCrossAccountRole

Sie müssen die an die Rolle anhängenEc2ImageBuilderCrossAccountDistributionAccess policy, um die kontoübergreifende Verteilung zu ermöglichen. Weitere Informationen zu verwalteten Richtlinien finden Sie im AWS Identity and Access Management Benutzerhandbuch unter Verwaltete Richtlinien und integrierte Richtlinien.

Stellen Sie sicher, dass die Quellkonto-ID zu der Vertrauensrichtlinie hinzugefügt wurde, die der IAM-Rolle des Zielkontos zugeordnet ist. Das folgende Beispiel zeigt eine Vertrauensrichtlinie im Zielkonto, die die Konto-ID des Quellkontos angibt.

Weitere Informationen zu Vertrauensrichtlinien finden Sie unter Resource-Based Richtlinien im AWS Identity and Access Management Benutzerhandbuch.

Wenn das AMI, das Sie verteilen, verschlüsselt ist, muss der Besitzer des Zielkontos seinem Konto die EC2ImageBuilderDistributionCrossAccountRole folgende Inline-Richtlinie hinzufügen, damit er Ihre KMS-Schlüssel verwenden kann. Der Principal Abschnitt enthält ihre Kontonummer. Dadurch kann Image Builder in ihrem Namen handeln, wenn das AMI mit AWS KMS den entsprechenden Schlüsseln für jede Region verschlüsselt und entschlüsselt wird.

Weitere Informationen zu integrierten Richtlinien finden Sie unter Inline-Richtlinien im AWS Identity and Access Management Benutzerhandbuch.

Wenn Sie eine Amazon EC2-Startvorlage verwendenlaunchTemplateConfigurations, müssen Sie EC2ImageBuilderDistributionCrossAccountRole in jedem Zielkonto außerdem die folgende Richtlinie zu Ihrer Vorlage hinzufügen.

Wenn Sie einen AWS Systems Manager Parameter Store-Parameter verwenden, um die AMI-ID des Ausgabe-AMI für das Vertriebskonto und die Region zu speichern, müssen Sie Ihrer EC2ImageBuilderDistributionCrossAccountRole in jedem Zielkonto die folgende Richtlinie hinzufügen.

Öffnen Sie die EC2 Image Builder-Konsole unter https://console.aws.amazon.com/imagebuilder/.

Wählen Sie im Navigationsbereich die Option Verteilungseinstellungen aus. Dies zeigt eine Liste der Verteilungseinstellungen, die unter Ihrem Konto erstellt wurden.

Wählen Sie oben auf der Seite mit den Verteilungseinstellungen die Option Verteilungseinstellungen erstellen aus. Dadurch gelangen Sie zur Seite „Verteilungseinstellungen erstellen“.

Wählen Sie im Abschnitt Image-Typ Amazon Machine Image (AMI) als Ausgabetyp aus. Dies ist die Standardeinstellung.

Geben Sie im Abschnitt Allgemein den Namen der Ressource für die Verteilungseinstellungen ein, die Sie erstellen möchten (erforderlich).

Geben Sie im Abschnitt Regionseinstellungen unter Zielkonten für die ausgewählte Region eine 12-stellige Konto-ID ein, an die Sie Ihr AMI verteilen möchten, und drücken Sie die Eingabetaste. Dadurch wird die korrekte Formatierung überprüft und anschließend die Konto-ID angezeigt, die Sie unter dem Feld eingegeben haben. Wiederholen Sie den Vorgang, um weitere Konten hinzuzufügen.

Um ein von Ihnen eingegebenes Konto zu entfernen, wählen Sie das X, das rechts neben der Konto-ID angezeigt wird.

Geben Sie den Ausgabe-AMI-Namen für jede Region ein.

Geben Sie weitere Einstellungen an, die Sie benötigen, und wählen Sie Einstellungen erstellen, um Ihre neue Ressource für Verteilungseinstellungen zu erstellen.

Konfigurieren Sie eine Datei mit den Distributionseinstellungen

Bevor Sie den create-image Befehl in der verwenden, AWS CLI um ein Image Builder-AMI zu erstellen, das an ein anderes Konto verteilt wird, müssen Sie eine DistributionConfiguration JSON-Struktur erstellen, die die Zielkonto-IDs in den AmiDistributionConfiguration Einstellungen angibt. Sie müssen mindestens eine AmiDistributionConfiguration in der Quellregion angeben.

Die folgende Beispieldatei mit dem Namen create-distribution-configuration.json zeigt die Konfiguration für die kontoübergreifende Bildverteilung in der Quellregion.

{
	"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"
		}
	]
}

Erstellen Sie die Verteilungseinstellungen

Um eine Ressource für Image Builder-Verteilungseinstellungen mit dem Befehl create-distribution-configuration in der zu erstellen AWS CLI, geben Sie im Befehl die folgenden Parameter an:

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