

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
<a name="cr-upd-container-distribution-settings"></a>

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

**Topics**
+ [Créez des paramètres de distribution pour les images de conteneurs Image Builder à partir du AWS CLI](#cli-create-container-distribution-configuration)
+ [Mettez à jour les paramètres de distribution de l'image de votre conteneur à partir du AWS CLI](#cli-update-container-distribution-configuration)

## Créez des paramètres de distribution pour les images de conteneurs Image Builder à partir du AWS CLI
<a name="cli-create-container-distribution-configuration"></a>

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"
   	}
   }
   ```

1. 

**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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** 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
<a name="cli-update-container-distribution-configuration"></a>

L'exemple suivant montre comment utiliser la **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** 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"]
   			}
   		}
   	]
   }
   ```

1. 

**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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** 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](tag-resources.md) section.