Erstellen und aktualisieren Sie AMI-Verteilungskonfigurationen

Ö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 Vertriebskonfigurationen, die unter Ihrem Konto erstellt wurden.

Wählen Sie oben im Bereich mit den Verteilungseinstellungen die Option Verteilungseinstellungen erstellen aus.

Wählen Sie im Abschnitt Image-Typ den Ausgabetyp Amazon Machine Image (AMI) aus.

Geben Sie im Abschnitt Allgemein einen Namen für Ihre Vertriebskonfiguration und optional eine Beschreibung ein.

Geben Sie im Abschnitt Regionseinstellungen die folgenden Details für jede Region ein, in der Sie Ihr AMI verteilen:

1. Das AMI wird standardmäßig an die aktuelle Region (Region 1) verteilt. Region 1 ist die Quelle für die Verteilung. Einige Einstellungen für Region 1 können nicht bearbeitet werden. Für alle Regionen, die Sie hinzufügen, können Sie eine Region aus der Dropdownliste Region auswählen.

   Der KMS-Schlüssel identifiziert den Schlüssel AWS KMS key , der zum Verschlüsseln der EBS-Volumes für Ihr Bild in der Zielregion verwendet wird. Es ist wichtig zu beachten, dass dies nicht für das ursprüngliche AMI gilt, das der Build unter Ihrem Konto in der Quellregion (Region 1) erstellt. Die Verschlüsselung, die während der Verteilungsphase des Builds ausgeführt wird, gilt nur für Images, die an andere Konten oder Regionen verteilt werden.

   Um die EBS-Volumes für das AMI zu verschlüsseln, das in der Quellregion für Ihr Konto erstellt wurde, müssen Sie den KMS-Schlüssel in der Image-Rezepturblock-Gerätezuordnung (Speicher (Volumes) in der Konsole) festlegen.

   Image Builder kopiert das AMI auf die Zielkonten, die Sie für die Region angeben.

   Voraussetzung

   Um ein Image kontenübergreifend zu kopieren, müssen Sie die EC2ImageBuilderDistributionCrossAccountRole Rolle in allen Zielkonten der Verteilung erstellen und die Ec2ImageBuilderCrossAccountDistributionAccess policy verwaltete Richtlinie an die Rolle anhängen.

   Der Ausgabe-AMI-Name ist optional. Wenn Sie einen Namen angeben, enthält der endgültige Ausgabe-AMI-Name einen angehängten Zeitstempel, der angibt, wann das AMI erstellt wurde. Wenn Sie keinen Namen angeben, hängt Image Builder den Build-Zeitstempel an den Rezeptnamen an. Dadurch werden eindeutige AMI-Namen für jeden Build gewährleistet.

   1. Mit AMI-Sharing können Sie bestimmten AWS Principals Zugriff gewähren, um Instances von Ihrem AMI aus zu starten. Wenn Sie den Abschnitt AMI-Sharing erweitern, können Sie die folgenden Details eingeben:

      • Startberechtigungen — Wählen Sie Privat aus, wenn Sie Ihr AMI geheim halten und bestimmten AWS Principals Zugriff gewähren möchten, um eine Instance von Ihrem privaten AMI aus zu starten. Wählen Sie Öffentlich, wenn Sie Ihr AMI öffentlich machen möchten. Jeder AWS Principal kann eine Instance von Ihrem öffentlichen AMI aus starten.

      • Principals — Sie können den folgenden Typen von AWS Principals Zugriff zum Starten von Instances gewähren:

        • AWS Konto — Zugriff auf ein bestimmtes Konto gewähren AWS

        • Organisationseinheit (OU) — Gewähren Sie Zugriff auf eine OU und all ihre untergeordneten Entitäten. Zu den untergeordneten Entitäten gehören Organisationseinheiten und AWS Konten.

        • Organisation — Gewähren Sie Zugriff auf Ihre AWS Organizations und alle untergeordneten Entitäten. Zu den untergeordneten Entitäten gehören Organisationseinheiten und AWS Konten.

          Wählen Sie zunächst den Prinzipaltyp aus. Geben Sie dann die ID für den AWS Principal, dem Sie Zugriff gewähren möchten, in das Feld rechts neben der Dropdownliste ein. Sie können mehrere IDs unterschiedlichen Typs eingeben.

   2. Sie können den Abschnitt Lizenzkonfiguration erweitern, um Lizenzkonfigurationen, die mit AWS License Manager Ihren Image Builder-Images erstellt wurden, anzuhängen. Lizenzkonfigurationen enthalten Lizenzregeln, die auf den Bedingungen Ihrer Unternehmensvereinbarungen basieren. Image Builder schließt automatisch Lizenzkonfigurationen ein, die Ihrem Basis-AMI zugeordnet waren.

   3. Sie können den Abschnitt zur Konfiguration der Startvorlage erweitern, um eine EC2-Startvorlage anzugeben, die zum Starten von Instances über das von Ihnen erstellte AMI verwendet werden soll.

      Wenn Sie eine EC2-Startvorlage verwenden, können Sie Image Builder anweisen, nach Abschluss des Builds eine neue Version Ihrer Startvorlage zu erstellen, die die neueste AMI-ID enthält. Um die Startvorlage zu aktualisieren, konfigurieren Sie die Einstellungen wie folgt:

      • Name der Startvorlage — Wählen Sie den Namen der Startvorlage aus, die Image Builder aktualisieren soll.

      • Standardversion festlegen — Wählen Sie dieses Kontrollkästchen, um die Standardversion der Startvorlage auf die neue Version zu aktualisieren.

      Um eine weitere Startvorlagenkonfiguration hinzuzufügen, wählen Sie Startvorlagenkonfiguration hinzufügen. Sie können bis zu fünf Startvorlagenkonfigurationen pro Region verwenden.

   4. Sie können den Abschnitt SSM-Parameterkonfigurationen erweitern, um einen SSM-Parameter zu konfigurieren, der die Ausgabe-AMI-ID für das Image speichert, das an die Zielregion verteilt wird. Sie können optional ein Vertriebskonto in der Region angeben.

      Parametername — Geben Sie den Namen für Ihren Parameter ein. Zum Beispiel /output/image/param.

      Datentyp — Behalten Sie den Standardwert (AWS EC2 Image) bei. Dadurch wird Systems Manager angewiesen, den Parameterwert zu überprüfen, um sicherzustellen, dass es sich um eine gültige AMI-ID handelt.

2. Um Verteilungseinstellungen für eine andere Region hinzuzufügen, wählen Sie Region hinzufügen.

Wählen Sie Einstellungen erstellen, wenn Sie fertig sind.

Erstellen einer CLI-Eingabe-JSON-Datei

Verwenden Sie ein Tool zur Dateibearbeitung, um eine JSON-Datei mit Schlüsseln zu erstellen, die in einem der folgenden Beispiele gezeigt werden, und Werten, die für Ihre Umgebung gültig sind. In diesen Beispielen wird definiert AWS-Konten, welche AWS Organizations oder welche Organisationseinheiten (OUs) berechtigt sind, das AMI zu starten, das Sie an die angegebenen Regionen verteilen. Benennen Sie die Dateicreate-ami-distribution-configuration.json, die im nächsten Schritt verwendet werden soll:

Beispiel 1: Verteilen an AWS-Konten

In diesem Beispiel wird ein AMI auf zwei Regionen verteilt und angegeben AWS-Konten , welche über Startberechtigungen in jeder Region verfügen.

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

Beispiel 2: An Organisationen und Organisationseinheiten verteilen

In diesem Beispiel wird ein AMI an die Quellregion verteilt und die Startberechtigungen für Organisation und Organisationseinheit angegeben.

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

Beispiel 3: Speichern Sie die Ausgabe-AMI-ID in einem SSM-Parameter

In diesem Beispiel wird die Ausgabe-AMI-ID in einem AWS Systems Manager Parameter Store-Parameter in der Verteilungsregion gespeichert.

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

Führen Sie den folgenden Befehl aus, indem Sie die Datei verwenden, die Sie als Eingabe erstellt haben.

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

Weitere Informationen finden Sie create-distribution-configuration in der AWS CLI Befehlsreferenz.

Ö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 Vertriebskonfigurationen, die unter Ihrem Konto erstellt wurden.

Um Details anzuzeigen oder eine Vertriebskonfiguration zu aktualisieren, wählen Sie den Link Konfigurationsname. Dadurch wird die Detailansicht für die Verteilungseinstellungen geöffnet.

Um die Verteilungskonfiguration zu bearbeiten, wählen Sie in der oberen rechten Ecke des Abschnitts mit den Verteilungsdetails die Option Bearbeiten aus. Einige Felder sind gesperrt, z. B. der Name der Verteilungskonfiguration und die Standardregion, die als Region 1 angezeigt wird. Weitere Informationen zu den Einstellungen der Distributionskonfiguration finden Sie unterErstellen Sie eine AMI-Verteilungskonfiguration.

Wählen Sie abschließend Änderungen speichern aus.

Erstellen einer CLI-Eingabe-JSON-Datei

Verwenden Sie ein Tool zur Dateibearbeitung, um eine JSON-Datei mit den im folgenden Beispiel gezeigten Schlüsseln und Werten, die für Ihre Umgebung gültig sind, zu erstellen. In diesem Beispiel wird eine Datei mit dem Namen verwendet. 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"
					]
				}
			}
		}
	]
}

Führen Sie den folgenden Befehl aus, indem Sie die Datei verwenden, die Sie als Eingabe erstellt haben.

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

Weitere Informationen finden Sie update-distribution-configuration in der AWS CLI Befehlsreferenz. Informationen zum Aktualisieren der Tags für Ihre Ressource zur Distributionskonfiguration finden Sie im Markieren von Ressourcen Abschnitt.