Especificar um sistema de arquivos do Amazon EFS na definição de tarefa do Amazon ECS
Para usar volumes do sistema de arquivos do Amazon EFS para seus contêineres, você deve especificar as configurações de volume e ponto de montagem na definição de tarefa. O trecho JSON de definição de tarefa a seguir mostra a sintaxe para os objetos volumes
e mountPoints
de um contêiner.
{ "containerDefinitions": [ { "name": "
container-using-efs
", "image": "amazonlinux:2
", "entryPoint": [ "sh", "-c" ], "command": [ "ls -la/mount/efs
" ], "mountPoints": [ { "sourceVolume": "myEfsVolume
", "containerPath": "/mount/efs
", "readOnly":true
} ] } ], "volumes": [ { "name": "myEfsVolume
", "efsVolumeConfiguration": { "fileSystemId": "fs-1234
", "rootDirectory": "/path/to/my/data
", "transitEncryption": "ENABLED
", "transitEncryptionPort":integer
, "authorizationConfig": { "accessPointId": "fsap-1234
", "iam": "ENABLED
" } } } ] }
efsVolumeConfiguration
-
Tipo: Objeto
Obrigatório: Não
Esse parâmetro é especificado quando volumes Amazon EFS são usados.
fileSystemId
-
Tipo: string
Obrigatório: Sim
A ID do sistema de arquivamento Amazon EFS a ser usada.
rootDirectory
-
Tipo: string
Obrigatório: Não
O diretório dentro do sistema de arquivamento Amazon EFS a ser montado como diretório raiz dentro do host. Caso esse parâmetro seja omitido, a raiz do volume Amazon EFS será usada. Especificar
/
tem o mesmo efeito que omitir esse parâmetro.Importante
Se um ponto de acesso do EFS for especificado no
authorizationConfig
, o parâmetro do diretório raiz deverá ser omitido ou definido como/
, o que imporá o caminho definido no ponto de acesso do EFS. transitEncryption
-
Tipo: string
Valores válidos:
ENABLED
|DISABLED
Obrigatório: Não
Especifica se a criptografia deve ou não ser habilitada para dados do Amazon EFS em trânsito entre o host do Amazon ECS e o servidor do Amazon EFS. A criptografia de trânsito deverá ser habilitada se a autorização do IAM do Amazon EFS for usada. Se o parâmetro for omitido, o valor padrão
DISABLED
será usado. Para obter mais informações, consulte Criptografar dados em trânsito no Guia do usuário do Amazon Elastic File System. transitEncryptionPort
-
Tipo: número inteiro
Obrigatório: Não
A porta a ser usada ao enviar dados criptografados entre o host do Amazon ECS e o servidor do Amazon EFS. Se você não especificar uma porta de criptografia em trânsito, será usada a estratégia de seleção de porta usada pelo assistente de montagem do Amazon EFS. Para mais informações, consulte Auxiliar de Montagem EFS no Guia de Usuário Amazon Elastic File System.
authorizationConfig
-
Tipo: Objeto
Obrigatório: Não
Detalhes de configuração de autorização do sistema de arquivamento Amazon EFS.
accessPointId
-
Tipo: Sequência
Obrigatório: Não
ID do ponto de acesso a ser usado. Se um ponto de acesso for especificado, o valor do diretório raiz no
efsVolumeConfiguration
deve ser omitido ou definido como/
, que impõe o caminho definido no ponto de acesso do EFS. Se um ponto de acesso for usado, a criptografia em trânsito deverá ser habilitada emEFSVolumeConfiguration
. Para mais informações, consulte Trabalhando com Pontos de Acesso Amazon EFS no Guia de Usuário Amazon Elastic File System. iam
-
Tipo: string
Valores válidos:
ENABLED
|DISABLED
Obrigatório: Não
Especifica se é necessário ou não usar o perfil do IAM para a tarefa do Amazon ECS estabelecida em uma definição de tarefa ao montar o sistema de arquivos do Amazon EFS. Em caso positivo, a criptografia de trânsito deve estar habilitada em
EFSVolumeConfiguration
. Se o parâmetro for omitido, o valor padrãoDISABLED
será usado. Para obter mais informações, consulte Funções do IAM para tarefas.