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à.
Volumi dei File di Amazon S3
S3 Files fornisce l'accesso diretto al file system ai dati archiviati nei bucket Amazon Simple Storage Service (Amazon S3). Con AWS Batch, puoi definire i volumi di S3 Files nelle definizioni dei tuoi job in modo che i tuoi contenitori possano leggere e scrivere dati Amazon S3 utilizzando operazioni sui file standard.
Per utilizzare i volumi S3 Files, sono necessari un file system S3 e una destinazione di montaggio configurati nello stesso VPC dell'ambiente di elaborazione. AWS Batch Per istruzioni di configurazione complete, tra cui configurazione del bucket, ruoli IAM, creazione di file system e obiettivi di montaggio, consulta i prerequisiti di S3 Files nella Amazon S3 User Guide e Configurazione dei file S3 per Amazon ECS nella Amazon Elastic Container Service Developer Guide.
Considerazioni sul volume dei file Amazon S3
Quando utilizzi i volumi S3 Files, considera quanto segue:
-
Puoi utilizzare i volumi S3 Files con gli ambienti di calcolo Fargate, Amazon EC2 e Amazon ECS Managed Instances. Negli ambienti di calcolo Amazon EC2, il supporto di S3 Files richiede la versione dell'agente contenitore Amazon ECS inclusa nelle AMI Amazon recenti. ECS-optimized Qualsiasi ambiente di calcolo Amazon EC2 creato dopo il 19 giugno 2026 include questo supporto per impostazione predefinita. Per aggiungere il supporto per S3 Files a un ambiente di calcolo Amazon EC2 esistente, aggiorna l'ambiente di calcolo alla versione più recente di Amazon AMI. ECS-optimized Per ulteriori informazioni, consulta Gestione delle versioni AMI negli ambienti di elaborazione.
-
La crittografia di transito è sempre abilitata per i volumi S3 Files. Facoltativamente, è possibile specificare la porta utilizzando il
transitEncryptionPortparametro. La porta predefinita è2049. -
Il ruolo lavorativo (equivalente al ruolo di attività di Amazon ECS) deve disporre
s3files:ClientMounts3files:ClientWritedelle autorizzazioni necessarie sul file system. Per le letture dirette da Amazon S3, il ruolo richiede anche les3:GetObjects3:ListBucketautorizzazioni sul bucket.s3:GetObjectVersion -
La destinazione di montaggio del file system S3 deve trovarsi nello stesso VPC e raggiungibile dalle sottoreti del tuo ambiente di elaborazione. AWS Batch Il gruppo di sicurezza mount target deve consentire il traffico NFS in entrata (porta TCP 2049) dal gruppo di sicurezza dell'ambiente di calcolo.
Usa i punti di accesso Amazon S3 Files
I punti di accesso S3 Files sono punti di ingresso specifici dell'applicazione in un file system che impongono un'identità utente POSIX e una directory principale per tutte le richieste del file system. È possibile utilizzare i punti di accesso per isolare i tenant in modo che ogni job possa accedere solo alla propria directory all'interno di un file system condiviso.
Nota
Quando si specifica un punto di accesso utilizzando il accessPointArn parametro, questo rootDirectory deve essere omesso o impostato su. / Il punto di accesso impone il proprio percorso di directory principale.
Per ulteriori informazioni sulla creazione e la gestione dei punti di accesso, consulta Creazione di punti di accesso per un file system S3 nella Amazon S3 User Guide. Per ulteriori informazioni sull'utilizzo delle policy dei file system per imporre l'isolamento dei punti di accesso, consulta How S3 Files works with IAM nella Amazon S3 User Guide.
Specifica un file system Amazon S3 Files nella definizione del tuo lavoro
Per utilizzare i volumi S3 Files per i tuoi contenitori, devi specificare le configurazioni del volume e del punto di montaggio nella definizione del processo. Il seguente frammento JSON della definizione del lavoro mostra la sintassi per gli oggetti e per un contenitore: volumes mountPoints
{ "ecsProperties": { "taskProperties": [ { ..., "taskRoleArn": "arn:aws:iam::<account>:role/<job-role-name>", "containers": [ { ..., "mountPoints": [ { "sourceVolume": "myS3FilesVolume", "containerPath": "/mnt/s3data", "readOnly":false} ] } ], "volumes": [ { "name": "myS3FilesVolume", "s3filesVolumeConfiguration": { "fileSystemArn": "arn:aws:s3files:<region>:<account>:file-system/<fs-id>", "rootDirectory": "/keypath/in/s3" } } ] } ] } }
s3filesVolumeConfiguration-
Tipo: oggetto
Obbligatorio: no
Questo parametro viene specificato quando si utilizzano i volumi S3 Files.
fileSystemArn-
Tipo: stringa
Obbligatorio: sì
L'ARN completo del file system S3 da utilizzare.
rootDirectory-
▬Tipo: stringa
Obbligatorio: no
La directory all'interno del file system S3 da montare come directory principale all'interno dell'host. Se questo parametro viene omesso, viene utilizzata la radice del file system. La specifica di
/avrà lo stesso effetto dell'omissione di questo parametro. Può contenere fino a 4.096 caratteri.Importante
Se viene specificato un punto di accesso S3 Files in
accessPointArn, il parametro della directory principale deve essere omesso o impostato su./Ciò impone il percorso impostato sul punto di accesso. transitEncryptionPort-
Tipo: Integer
Obbligatorio: no
La porta da utilizzare per l'invio di dati crittografati tra l' AWS Batch host e il server S3 Files. Se non si specifica una porta di crittografia di transito,
2049viene utilizzato il valore predefinito di. Il valore deve essere compreso tra 0 e 65.535. La crittografia dei transiti è sempre abilitata per i volumi S3 Files. accessPointArn-
▬Tipo: stringa
Obbligatorio: no
L'ARN del punto di accesso S3 Files da utilizzare. Se viene specificato un punto di accesso, il valore della directory principale in
s3filesVolumeConfigurationdeve essere omesso o impostato su./Ciò impone il percorso impostato sul punto di accesso. I punti di accesso impongono un'identità utente POSIX e possono limitare l'accesso a directory specifiche all'interno del file system. Per ulteriori informazioni, consulta Creazione di punti di accesso per un file system S3 nella Amazon S3 User Guide.
Usa i volumi S3 Files con AWS Batch e Amazon EKS
Per i lavori che utilizzano risorse Amazon EKS, AWS Batch supporta i volumi S3 Files tramite una configurazione del volume di definizione del lavoro persistentVolumeClaim in EKS. È necessario precreare il volume persistente e l'attestazione del volume persistente nel cluster Amazon EKS prima di farvi riferimento nella definizione del lavoro.
Il seguente frammento di definizione del job mostra come fare riferimento a un'attestazione di volume persistente di S3 Files:
{ "eksProperties": { "podProperties": { ..., "containers": [ { ..., "volumeMounts": [ { "name": "s3files-vol", "mountPath": "/mnt/s3data" } ] } ], "volumes": [ { "name": "s3files-vol", "persistentVolumeClaim": { "claimName": "<s3files-pvc-name>" } } ] } } }
Per ulteriori informazioni sulla configurazione dei file S3 con Amazon EKS, consulta Mounting S3 file system in Amazon EKS nella Amazon S3 User Guide. Per il riferimento completo ai parametri del volume, consulta EksVolume l'AWS Batch API Reference.