As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Volumes de arquivos do Amazon S3

O S3 Files fornece acesso direto ao sistema de arquivos aos dados armazenados nos buckets do Amazon Simple Storage Service (Amazon S3). Com AWS Batch, você pode definir volumes de arquivos do S3 em suas definições de trabalho para que seus contêineres possam ler e gravar dados do Amazon S3 usando operações de arquivo padrão.

Para usar volumes de arquivos S3, você precisa de um sistema de arquivos S3 e de um destino de montagem configurados na mesma VPC do seu ambiente computacional. AWS Batch Para obter instruções completas de configuração, incluindo configuração de bucket, funções do IAM, criação do sistema de arquivos e destinos de montagem, consulte Pré-requisitos de arquivos S3 no Guia do usuário do Amazon S3 e Configuração de arquivos S3 para o Amazon ECS no Guia do desenvolvedor do Amazon Elastic Container Service.

Considerações sobre o volume de arquivos do Amazon S3

Considere o seguinte ao usar volumes do S3 Files:

Use pontos de acesso do Amazon S3 Files

Os pontos de acesso do S3 Files são pontos de entrada específicos do aplicativo em um sistema de arquivos que impõem uma identidade de usuário POSIX e um diretório raiz para todas as solicitações do sistema de arquivos. Você pode usar pontos de acesso para isolar inquilinos para que cada trabalho possa acessar somente seu próprio diretório em um sistema de arquivos compartilhado.

Para obter mais informações sobre como criar e gerenciar pontos de acesso, consulte Criação de pontos de acesso para um sistema de arquivos S3 no Guia do usuário do Amazon S3. Para obter mais informações sobre o uso de políticas do sistema de arquivos para impor o isolamento do ponto de acesso, consulte Como o S3 Files funciona com o IAM no Guia do usuário do Amazon S3.

Especifique um sistema de arquivos Amazon S3 Files em sua definição de trabalho

Para usar os volumes do S3 Files em seus contêineres, você deve especificar as configurações de volume e ponto de montagem na definição do seu trabalho. O trecho JSON de definição de tarefa a seguir mostra a sintaxe para os objetos volumes e mountPoints de um contêiner:

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

Use volumes de arquivos do S3 com o AWS Batch Amazon EKS

Para trabalhos que usam recursos do Amazon EKS, AWS Batch oferece suporte a volumes de arquivos S3 por meio de uma configuração persistentVolumeClaim de volume de definição de tarefas do EKS. Você deve pré-criar o volume persistente e a declaração de volume persistente no seu cluster do Amazon EKS antes de referenciá-los na sua definição de trabalho.

O trecho de definição de tarefa a seguir mostra como fazer referência a uma declaração de volume persistente do S3 Files:

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

Para obter mais informações sobre a configuração de arquivos S3 com o Amazon EKS, consulte Montagem de sistemas de arquivos S3 no Amazon EKS no Guia do usuário do Amazon S3. Para ver a referência completa dos parâmetros de volume, consulte EksVolumea Referência AWS Batch da API.