

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Archiviazione della configurazione di un'istanza di container Amazon ECS in Amazon S3
<a name="ecs-config-s3"></a>

La configurazione dell'agente del container Amazon ECS viene controllata con la variabile di ambiente. Varianti Linux di Amazon ECS-optimized AMI cerca queste variabili in `/etc/ecs/ecs.config` quando l'agente contenitore si avvia e configura l'agente di conseguenza. Non-sensative variabili di ambiente, come `ECS_CLUSTER`, possono essere passati all'istanza del contenitore all'avvio tramite i dati utente di Amazon EC2 e scritti in questo file senza conseguenze. Tuttavia, altre informazioni sensibili, come la tua AWS credenziali o `ECS_ENGINE_AUTH_DATA` variabile, non deve mai essere passata a un'istanza nei dati utente o scritta `/etc/ecs/ecs.config` in un modo che consentirebbe loro di apparire in un `.bash_history` file.

Archiviare le informazioni di configurazione in un bucket privato in Amazon S3 e concedere l'accesso in sola lettura al ruolo IAM dell'istanza di container è un modo sicuro e conveniente per permettere la configurazione delle istanze di container all'avvio. È possibile memorizzare una copia del file `ecs.config` in un bucket privato. È quindi possibile utilizzare i dati utente di Amazon EC2 per installare AWS CLI e copia le informazioni di configurazione su `/etc/ecs/ecs.config` all'avvio dell'istanza.

**Per memorizzare un `ecs.config` file in Amazon S3**

1. È necessario concedere il ruolo di istanza del contenitore (**ecsInstanceRole**) autorizzazioni per avere accesso in sola lettura ad Amazon S3. Puoi farlo assegnando il **AmazonS3ReadOnlyAccess** al `ecsInstanceRole` ruolo. Per informazioni su come associare una policy a un ruolo, consulta [Aggiornare le autorizzazioni per un ruolo](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html) nella *Guida per l'utente di AWS Identity and Access Management *

1. Crea un file `ecs.config` con variabili di configurazione dell'agente Amazon ECS valide utilizzando il seguente formato. In questo esempio viene configurata l'autenticazione di un registro privato. Per ulteriori informazioni, consulta [Usando non-AWS immagini dei contenitori in 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}}"}}
   ```
**Nota**  
Per un elenco completo delle variabili di configurazione degli agenti Amazon ECS disponibili, consulta [Amazon ECS Container Agent](https://github.com/aws/amazon-ecs-agent/blob/master/README.md) sul GitHub.

1. Per archiviare il file di configurazione, crea un bucket privato in Amazon S3. Per ulteriori informazioni, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l'utente di Amazon Simple Storage Service*. 

1. Carica il file `ecs.config` nel bucket S3. Per ulteriori informazioni, consulta [Caricamento degli oggetti](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) nella *Guida per l'utente di Amazon Simple Storage Service*.

**Per caricare un `ecs.config` file da Amazon S3 al momento del lancio**

1. Procedi come indicato in questa sezione per consentire l'accesso Amazon S3 in sola lettura alle istanze di container e archiviare un file `ecs.config` in un bucket privato S3.

1. Avvia nuove istanze di container e utilizza il seguente script di esempio nei dati utente EC2. Lo script installa AWS CLI e copia il file di configurazione in `/etc/ecs/ecs.config`. Per ulteriori informazioni, consulta [Avvio di un'istanza di container Linux di Amazon ECS](launch_container_instance.md).

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