View a markdown version of this page

Erstellen und aktualisieren Sie die Verteilungseinstellungen für Container-Images - EC2 Image Builder
Erstellen Sie Verteilungseinstellungen für Image Builder-Container-Images aus dem AWS CLIAktualisieren Sie die Verteilungseinstellungen für Ihr Container-Image über das AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen und aktualisieren Sie die Verteilungseinstellungen für Container-Images

In diesem Abschnitt wird das Erstellen und Aktualisieren von Verteilungseinstellungen für Image Builder-Container-Images behandelt.

Erstellen Sie Verteilungseinstellungen für Image Builder-Container-Images aus dem AWS CLI

Eine Verteilungskonfiguration ermöglicht es Ihnen, den Namen und die Beschreibung Ihres Ausgabe-Container-Images anzugeben und das Container-Image in andere AWS Regionen zu replizieren. Sie können der Ressource für die Distributionskonfiguration und die Container-Images in jeder Region auch separate Tags zuweisen.

  1. Erstellen einer CLI-Eingabe-JSON-Datei

    Verwenden Sie Ihr bevorzugtes Tool zur Dateibearbeitung, um eine JSON-Datei mit den im folgenden Beispiel gezeigten Schlüsseln sowie Werten, die für Ihre Umgebung gültig sind, zu erstellen. In diesem Beispiel wird eine Datei mit dem Namencreate-container-distribution-configuration.json:

    {
	"name": "distribution-configuration-name",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
		{
			"region": "us-west-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
				"containerTags": ["west2", "image1"]
			}
		},
		{
			"region": "us-east-1",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
			   "containerTags": ["east1", "imagedist"]
			}
		}
	],
	"tags": {
	   "DistributionConfigurationTestTagKey1": "DistributionConfigurationTestTagValue1",
	   "DistributionConfigurationTestTagKey2": "DistributionConfigurationTestTagValue2"
	}
}
  2. 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-container-distribution-configuration.json
    Anmerkung

    • Sie müssen diefile://-Notation am Anfang des JSON-Dateipfades.

    • Der Pfad für die JSON-Datei sollte der entsprechenden Konvention für das Basisbetriebssystem folgen, auf dem Sie den Befehl ausführen. Beispielsweise verwendet Windows den umgekehrten Schrägstrich (\), um auf den Verzeichnispfad zu verweisen, während Linux und macOS den Schrägstrich (/) verwenden.

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

Aktualisieren Sie die Verteilungseinstellungen für Ihr Container-Image über das AWS CLI

Das folgende Beispiel zeigt, wie Sie den update-distribution-configuration Befehl verwenden, um die Verteilungseinstellungen für Ihr Container-Image zu aktualisieren. Verwenden Sie dazu den AWS CLI. Sie können auch die Tags für die Container-Images in jeder Region aktualisieren.

  1. Erstellen einer CLI-Eingabe-JSON-Datei

    Verwenden Sie Ihr bevorzugtes Tool zur Dateibearbeitung, um eine JSON-Datei mit den im folgenden Beispiel gezeigten Schlüsseln sowie Werten, die für Ihre Umgebung gültig sind, zu erstellen. In diesem Beispiel wird eine Datei mit dem Namenupdate-container-distribution-configuration.json:

    {
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-container-distribution-configuration.json",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
		{
			"region": "us-west-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
				"containerTags": ["west2", "image1"]
			}
		},
		{
			"region": "us-east-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
			   "containerTags": ["east2", "imagedist"]
			}
		}
	]
}
  2. Führen Sie den folgenden Befehl aus und verwenden Sie dabei die von Ihnen erstellte Datei als Eingabe:
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
    Anmerkung

    • Sie müssen diefile://-Notation am Anfang des JSON-Dateipfades.

    • Der Pfad für die JSON-Datei sollte der entsprechenden Konvention für das Basisbetriebssystem folgen, auf dem Sie den Befehl ausführen. Beispielsweise verwendet Windows den umgekehrten Schrägstrich (\), um auf den Verzeichnispfad zu verweisen, während Linux und macOS den Schrägstrich (/) verwenden.

    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.