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.

Volumes de fichiers Amazon S3

S3 Files fournit un accès direct au système de fichiers aux données stockées dans des compartiments Amazon Simple Storage Service (Amazon S3). Avec AWS Batch, vous pouvez définir des volumes de fichiers S3 dans vos définitions de tâches afin que vos conteneurs puissent lire et écrire des données Amazon S3 à l'aide d'opérations de fichiers standard.

Pour utiliser les volumes S3 Files, vous avez besoin d'un système de fichiers S3 et d'une cible de montage configurés dans le même VPC que votre environnement AWS Batch informatique. Pour obtenir des instructions de configuration complètes, y compris la configuration des compartiments, les rôles IAM, la création du système de fichiers et les cibles de montage, consultez les conditions requises pour S3 Files dans le guide de l'utilisateur Amazon S3 et la configuration des fichiers S3 pour Amazon ECS dans le guide du développeur Amazon Elastic Container Service.

Considérations relatives au volume Amazon S3 Files

Tenez compte des points suivants lorsque vous utilisez des volumes S3 Files :

Utiliser les points d'accès Amazon S3 Files

Les points d'accès aux fichiers S3 sont des points d'entrée spécifiques à une application dans un système de fichiers qui imposent une identité d'utilisateur POSIX et un répertoire racine pour toutes les demandes du système de fichiers. Vous pouvez utiliser des points d'accès pour isoler les locataires afin que chaque tâche ne puisse accéder qu'à son propre répertoire au sein d'un système de fichiers partagé.

Pour plus d'informations sur la création et la gestion des points d'accès, consultez la section Création de points d'accès pour un système de fichiers S3 dans le guide de l'utilisateur Amazon S3. Pour plus d'informations sur l'utilisation de politiques de système de fichiers pour renforcer l'isolation des points d'accès, consultez Comment S3 Files works with IAM dans le guide de l'utilisateur Amazon S3.

Spécifiez un système de fichiers Amazon S3 Files dans votre définition de tâche

Pour utiliser les volumes S3 Files pour vos conteneurs, vous devez spécifier les configurations de volume et de point de montage dans votre définition de tâche. L'extrait JSON de définition de tâche suivant montre la syntaxe des mountPoints objets volumes et d'un conteneur :

{
    "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"
                        }
                    }
                ]
            }
        ]
    }
}

Utiliser des volumes S3 Files avec Amazon EKS AWS Batch et Amazon EKS

Pour les tâches qui utilisent les ressources Amazon EKS, AWS Batch prend en charge les volumes S3 Files via une configuration de volume intégrée persistentVolumeClaim à la définition des tâches EKS. Vous devez créer au préalable le volume persistant et la réclamation de volume persistant dans votre cluster Amazon EKS avant de le référencer dans votre définition de tâche.

L'extrait de définition de tâche suivant montre comment faire référence à une réclamation de volume persistant S3 Files :

{
    "eksProperties": {
        "podProperties": {
            ...,
            "containers": [
                {
                    ...,
                    "volumeMounts": [
                        {
                            "name": "s3files-vol",
                            "mountPath": "/mnt/s3data"
                        }
                    ]
                }
            ],
            "volumes": [
                {
                    "name": "s3files-vol",
                    "persistentVolumeClaim": {
                        "claimName": "<s3files-pvc-name>"
                    }
                }
            ]
        }
    }
}

Pour plus d'informations sur la configuration de fichiers S3 avec Amazon EKS, consultez la section Montage de systèmes de fichiers S3 dans Amazon EKS dans le guide de l'utilisateur Amazon S3. Pour la référence complète des paramètres de volume, voir EksVolumela référence de l'AWS Batch API.