

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.

# Stockage de la configuration d’instance de conteneur Amazon ECS dans Amazon S3

La configuration de l’agent de conteneur Amazon ECS est contrôlée avec les variables d’environnement. Variantes Linux d'Amazon ECS-optimized AMI recherche ces variables dans `/etc/ecs/ecs.config` lorsque l'agent de conteneur démarre et configurez-le en conséquence. Non-sensative variables d'environnement, telles que `ECS_CLUSTER`, peuvent être transmis à l'instance de conteneur lors du lancement via les données utilisateur Amazon EC2 et écrits dans ce fichier sans conséquence. Toutefois, d'autres informations sensibles, telles que votre AWS informations d'identification ou `ECS_ENGINE_AUTH_DATA` variable, ne doit jamais être transmise à une instance dans les données utilisateur ou écrite dans `/etc/ecs/ecs.config` d'une manière qui leur permettrait d'apparaître dans un `.bash_history` dossier.

Stocker les informations de configuration dans un compartiment privé d'Amazon S3 et accorder un accès en lecture seule au rôle IAM de votre instance de conteneur est un moyen pratique et sécurisé d'autoriser la configuration d'une instance de conteneur au moment du lancement. Vous pouvez stocker une copie de votre fichier `ecs.config` dans un compartiment privé. Vous pouvez ensuite utiliser les données utilisateur d'Amazon EC2 pour installer AWS CLI et copiez vos informations de configuration dans `/etc/ecs/ecs.config` au lancement de l'instance.

**Pour stocker un `ecs.config` fichier dans Amazon S3**

1. Vous devez attribuer le rôle d'instance de conteneur (**ecsInstanceRole**) autorisations pour avoir un accès en lecture seule à Amazon S3. Vous pouvez le faire en attribuant **AmazonS3ReadOnlyAccess** à la `ecsInstanceRole` rôle. Pour plus d’informations sur la manière d’associer une politique à un rôle, consultez la section [Modification des autorisations pour un rôle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html) dans le *Guide de l’utilisateur Gestion des identités et des accès AWS *.

1. Créez un fichier `ecs.config` contenant des variables de configuration d'agent Amazon ECS valides en utilisant le format suivant. Cet exemple configure l'authentification de registre privé. Pour plus d’informations, consultez [En utilisant des produits non AWS images de conteneurs dans Amazon ECS](private-auth.md).

   ```
   ECS_ENGINE_AUTH_TYPE=dockercfg
   ECS_ENGINE_AUTH_DATA={"https://index.docker.io/v1/":{"auth":"{{zq212MzEXAMPLE7o6T25Dk0i}}","email":"{{email@example.com}}"}}
   ```
**Note**  
Pour obtenir la liste complète des variables de configuration de l'agent Amazon ECS disponibles, consultez [Agent de conteneurs Amazon ECS](https://github.com/aws/amazon-ecs-agent/blob/master/README.md) sur GitHub.

1. Pour stocker votre fichier de configuration, créez un compartiment privé dans Amazon S3. Pour de plus amples informations, consultez la section [Création d’un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) dans le *Guide de l’utilisateur d’Amazon Simple Storage Service*. 

1. Chargez le fichier `ecs.config` dans votre compartiment S3. Pour plus d'informations, consultez [Chargement d'objets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) dans le *Guide de l'utilisateur Amazon Simple Storage Service*.

**Pour charger un `ecs.config` fichier depuis Amazon S3 au lancement**

1. Exécutez les précédentes procédures de la présente section pour autoriser l'accès en lecture seule d'Amazon S3 à vos instances de conteneur et stocker un fichier `ecs.config` dans un compartiment S3 privé.

1. Lancez de nouvelles instances de conteneur et utilisez l’exemple de script suivant dans les données utilisateur EC2. Le script installe AWS CLI et copie votre fichier de configuration dans `/etc/ecs/ecs.config`. Pour plus d’informations, consultez [Lancement d'une instance de conteneur Amazon ECS Linux](launch_container_instance.md).

   ```
   #!/bin/bash
   yum install -y aws-cli
   aws s3 cp s3://{{your_bucket_name}}/ecs.config /etc/ecs/ecs.config
   ```