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à.

# Configurazione dei file S3 per Amazon ECS
<a name="s3files-volumes"></a>

S3 Files è un file system condiviso che collega qualsiasi risorsa di AWS elaborazione direttamente con i tuoi dati in Amazon S3. Fornisce un accesso rapido e diretto a tutti i dati S3 sotto forma di file con semantica completa del file system e prestazioni a bassa latenza, senza che i dati escano mai da S3. Puoi leggere, scrivere e organizzare i dati utilizzando operazioni su file e directory, mentre S3 Files mantiene il file system e il bucket S3 sincronizzati automaticamente. Con Amazon ECS, puoi definire i file system S3 come volumi nelle definizioni delle attività, offrendo ai contenitori l'accesso diretto ai file system ai dati archiviati nei bucket S3. Per ulteriori informazioni su Amazon S3 Files e le sue funzionalità, consulta la [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) User Guide.

## Disponibilità
<a name="s3files-volume-availability"></a>

Il supporto per S3 Files in Amazon ECS è disponibile per i seguenti tipi di avvio a disponibilità generale:
+ **Fargate** — Completamente supportato.
+ **Amazon ECS Managed Instances**: supporto completo.

**Importante**  
Al momento i file S3 non sono supportati sul tipo di avvio di Amazon EC2. Se configuri un file system S3 in una definizione di attività e tenti di eseguirlo sul tipo di avvio di Amazon EC2, l'operazione avrà esito negativo all'avvio. Il supporto per il tipo di lancio di Amazon EC2 è previsto per le future release.

## Considerazioni
<a name="s3files-volume-considerations"></a>
+ Il file system S3 utilizza un `s3filesVolumeConfiguration` parametro dedicato nella definizione dell'attività.
+ Il file system S3 richiede un Amazon Resource Name (ARN) completo per identificare il file system. Il formato ARN è:

  ```
  arn:{{{partition}}}:s3files:{{{region}}}:{{{account-id}}}:file-system/{{fs-xxxxx}}
  ```
+ La crittografia di transito è obbligatoria per i volumi del file system S3 e viene applicata automaticamente. Non è possibile disattivarla.
+ Task IAM Role è obbligatorio per i volumi del file system S3 e viene applicato automaticamente. Non è disponibile alcuna opzione per disabilitarlo.

## Prerequisiti
<a name="s3files-volume-prerequisites"></a>

Prima di configurare i volumi del file system S3 nelle definizioni delle attività di Amazon ECS, assicurati che siano soddisfatti i seguenti prerequisiti:
+ **Un file system S3 e una destinazione di montaggio**: devi avere un file system S3 creato e associato a un bucket S3. Per istruzioni sulla creazione di un file system S3, consulta la [Amazon S3 Files](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) User Guide.
+ **Un ruolo Task IAM**: la definizione dell'attività deve includere un ruolo Task IAM con le seguenti autorizzazioni:
  + Autorizzazioni per connettersi e interagire con i file system S3 dal codice dell'applicazione (in esecuzione nel contenitore).
  + Autorizzazioni per leggere gli oggetti S3 dal codice dell'applicazione (in esecuzione nel contenitore).
+ **Configurazione di VPC e gruppi di sicurezza**: il file system S3 deve essere accessibile dal VPC e dalle sottoreti in cui vengono eseguite le attività di Amazon ECS.
+ **(Opzionale) Punti di accesso ai file S3**: se desideri applicare controlli di accesso specifici dell'applicazione, crea un punto di accesso S3 Files e fornisci l'ARN nella definizione dell'attività.

[Per ulteriori informazioni, consulta i prerequisiti per S3 Files.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-files-prereq-policies.html#s3-files-prereq-iam-compute-role)

## Parametri di configurazione del volume S3 Files
<a name="s3files-volume-parameters"></a>

La tabella seguente descrive i parametri disponibili nell'`s3filesVolumeConfiguration`oggetto:

`fileSystemArn`  
Tipo: stringa  
Obbligatorio: sì  
L'ARN completo del file system S3 da montare. Formato: `arn:{{{partition}}}:s3files:{{{region}}}:{{{account-id}}}:file-system/{{fs-xxxxx}}`

`rootDirectory`  
▬Tipo: stringa  
Obbligatorio: no  
La directory all'interno del file system S3 da montare come radice del volume. Se non specificato, viene usato il valore predefinito `/`.

`transitEncryptionPort`  
Tipo: Integer  
Obbligatorio: no  
La porta da utilizzare per l'invio di dati crittografati tra l'host Amazon ECS e il file system S3. La crittografia di transito stessa è sempre abilitata e non può essere disabilitata.

`accessPointArn`  
▬Tipo: stringa  
Obbligatorio: no  
L'ARN completo del punto di accesso S3 Files da utilizzare. I punti di accesso forniscono punti di ingresso specifici dell'applicazione nel file system con identità utente forzata e impostazioni della directory principale.