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 em 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 do S3, você precisa de um sistema de arquivos do S3 e do destino de montagem configurados na mesma VPC do seu AWS Batch ambiente de computação. 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 os pré-requisitos de arquivos do S3 no Guia do usuário do Amazon S3 e Configuração de arquivos do 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 de forma 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 os arquivos do S3 funcionam 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 em sua definição de 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 do S3 Files com AWS Batch e Amazon EKS

Para trabalhos que usam recursos do Amazon EKS, AWS Batch oferece suporte a volumes do S3 Files por meio de uma configuração de volume persistentVolumeClaim na definição de tarefas do EKS. Você deve pré-criar a declaração de volume persistente e volume persistente em seu cluster Amazon EKS antes de referenciá-los em 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 como configurar arquivos do S3 com o Amazon EKS, consulte Montando sistemas de arquivos do S3 no Amazon EKS no Guia do usuário do Amazon S3. Para ver a referência completa do parâmetro de volume, consulte EksVolume a Referência AWS Batch da API.