View a markdown version of this page

Création et mise à jour des paramètres de distribution pour les images de conteneurs - EC2 Image Builder
Créez des paramètres de distribution pour les images de conteneurs Image Builder à partir du AWS CLIMettez à jour les paramètres de distribution de l'image de votre conteneur à partir du AWS CLI

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création et mise à jour des paramètres de distribution pour les images de conteneurs

Cette section couvre la création et la mise à jour des paramètres de distribution pour les images de conteneur Image Builder.

Créez des paramètres de distribution pour les images de conteneurs Image Builder à partir du AWS CLI

Une configuration de distribution vous permet de spécifier le nom et la description de votre image de conteneur en sortie et de répliquer l'image de conteneur dans d'autres AWS régions. Vous pouvez également appliquer des balises distinctes à la ressource de configuration de distribution et aux images de conteneur dans chaque région.

  1. Créer un fichier JSON d'entrée CLI

    Utilisez votre outil d'édition de fichiers préféré pour créer un fichier JSON avec les clés illustrées dans l'exemple suivant, ainsi que des valeurs valides pour votre environnement. Cet exemple utilise un fichier nommécreate-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. Exécutez la commande suivante en utilisant le fichier que vous avez créé en entrée.
    aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json
    Note

    • Vous devez inclure l'option file:// au début du chemin du fichier JSON.

    • Le chemin d'accès du fichier JSON doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. Par exemple, Windows utilise la barre oblique inverse (\) pour faire référence au chemin du répertoire, tandis que Linux et macOS utilisent la barre oblique (/).

    Pour plus d'informations, consultez create-distribution-configuration la référence des AWS CLI commandes.

Mettez à jour les paramètres de distribution de l'image de votre conteneur à partir du AWS CLI

L'exemple suivant montre comment utiliser la update-distribution-configuration commande pour mettre à jour les paramètres de distribution de votre image de conteneur, à l'aide du AWS CLI. Vous pouvez également mettre à jour les balises pour les images de conteneurs dans chaque région.

  1. Créer un fichier JSON d'entrée CLI

    Utilisez votre outil d'édition de fichiers préféré pour créer un fichier JSON avec les clés illustrées dans l'exemple suivant, ainsi que des valeurs valides pour votre environnement. Cet exemple utilise un fichier nomméupdate-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. Exécutez la commande suivante en utilisant le fichier que vous avez créé comme entrée :
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
    Note

    • Vous devez inclure l'option file:// au début du chemin du fichier JSON.

    • Le chemin d'accès du fichier JSON doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. Par exemple, Windows utilise la barre oblique inverse (\) pour faire référence au chemin du répertoire, tandis que Linux et macOS utilisent la barre oblique (/).

    Pour plus d'informations, consultez update-distribution-configuration la référence des AWS CLI commandes. Pour mettre à jour les balises de votre ressource de configuration de distribution, consultez la Balisage des ressources section.