Seção [efs] - AWS ParallelCluster

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á.

Seção [efs]

Define a configuração para o Amazon EFS que está montado nos nós principal e de computação. Para obter mais informações, consulte CreateFileSystem na Referência da API do Amazon EFS.

Para saber como incluir sistemas de arquivos do Amazon EFS em sua definição de cluster, consulte Seção [cluster] / efs_settings.

Para usar um sistema de arquivos existente do Amazon EFS para armazenamento permanente de longo prazo que seja independente do ciclo de vida do cluster, especifique efs_fs_id.

Se você não especificar efs_fs_id, AWS ParallelCluster cria sistema de arquivos do Amazon EFS a partir das configurações [efs] ao criar o cluster e exclui o sistema de arquivos e os dados quando o cluster é excluído.

Para ter mais informações, consulte Melhores práticas: mover um cluster para uma nova versão AWS ParallelCluster secundária ou de patch.

O formato é [efs efs-name]. efs-name deve começar com uma letra, conter no máximo 30 caracteres e conter apenas letras, números, hifens (-) e sublinhados (_).

[efs customfs] shared_dir = efs encrypted = false performance_mode = generalPurpose

efs_fs_id

(Opcional) Define o ID do sistema de arquivos do Amazon EFS para um sistema de arquivos existente.

Especificar essa opção invalida todas as outras opções do Amazon EFS, exceto shared_dir.

Se você definir essa opção, serão compatíveis apenas os seguintes sistemas de arquivos:

  • Sistemas de arquivos que não tenham um destino de montagem na zona de disponibilidade da pilha.

  • Sistemas de arquivos que têm um destino de montagem existente na zona de disponibilidade da pilha, com o tráfego de entrada e saída do NFS permitidos a partir de 0.0.0.0/0.

A verificação de sanidade para validar o efs_fs_id requer a função do IAM para ter as seguintes permissões:

  • elasticfilesystem:DescribeMountTargets

  • elasticfilesystem:DescribeMountTargetSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeSecurityGroups

  • ec2:DescribeNetworkInterfaceAttribute

Para evitar erros, é necessário adicionar essas permissões à função do IAM ou definir sanity_check = false.

Importante

Ao definir um destino de montagem com o tráfego de entrada e saída do NFS permitido de 0.0.0.0/0, o sistema de arquivos é exposto a solicitações de montagem do NFS de qualquer lugar na zona de disponibilidade do destino de montagem. O AWS não recomenda criar um destino de montagem na zona de disponibilidade da pilha. Em vez disso, deixe o AWS lidar com essa etapa. Caso deseje ter um destino de montagem na zona de disponibilidade da pilha, considere o uso de um grupo de segurança personalizado, fornecendo uma opção vpc_security_group_id na seção [vpc]. Depois, adicione o grupo de segurança ao destino de montagem e desative sanity_check para criar o cluster.

Não há valor padrão.

efs_fs_id = fs-12345

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

efs_kms_key_id

(Opcional) Identifica a chave gerenciada pelo cliente AWS Key Management Service (AWS KMS) a ser usada para proteger o sistema de arquivos criptografado. Se isso estiver definido, a encrypted configuração deverá ser definida como true. Isso corresponde ao parâmetro KmsKeyId na Referência de API do Amazon EFS.

Não há valor padrão.

efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

encrypted

(Opcional) Indica se o sistema de arquivos está criptografado. Isso corresponde ao parâmetro Encrypted na Referência de API do Amazon EFS.

O valor padrão é false.

encrypted = true

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

performance_mode

(Opcional) Define o modo de desempenho do sistema de arquivos. Isso corresponde ao parâmetro PerformanceMode na Referência de API do Amazon EFS.

As opções válidas são as seguintes:

  • generalPurpose

  • maxIO

Ambos os valores diferenciam maiúsculas de minúsculas.

Recomendamos o modo de desempenho generalPurpose para a maioria dos sistemas de arquivos.

Os sistemas de arquivos que usam o modo de desempenho maxIO podem ser dimensionados para níveis superiores de throughput e operações por segundo agregadas. No entanto, há um compromisso com latências um pouco mais altas para a maioria das operações de arquivo.

Esse parâmetro não poderá ser alterado depois que o sistema de arquivos for criado.

O valor padrão é generalPurpose.

performance_mode = generalPurpose

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

provisioned_throughput

(Opcional) Define o throughput provisionado do sistema de arquivos, medido em MiB/s. Isso corresponde ao parâmetro ProvisionedThroughputInMibps na Referência de API do Amazon EFS.

Se você usar esse parâmetro, deverá definir throughput_mode como provisioned.

A quota do throughput é de 1024 MiB/s. Para solicitar um aumento na cota, entre em contato com o Suporte.

O valor mínimo é 0.0 MiB/s

provisioned_throughput = 1024

Política de atualização: essa configuração pode ser alterada durante uma atualização.

shared_dir

(Obrigatório) Define o ponto de montagem do Amazon EFS nos nós principal e de computação.

Esse parâmetro é obrigatório. A seção do Amazon EFS só é usada se shared_dir for especificado.

Não use NONE ou /NONE como o diretório compartilhado.

O exemplo a seguir monta o Amazon EFS no /efs.

shared_dir = efs

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

throughput_mode

(Opcional) Define o modo de throughput do sistema de arquivos. Isso corresponde ao parâmetro ThroughputMode na Referência de API do Amazon EFS.

As opções válidas são as seguintes:

  • bursting

  • provisioned

O valor padrão é bursting.

throughput_mode = provisioned

Política de atualização: essa configuração pode ser alterada durante uma atualização.