[efs] 部分 - Amazon ParallelCluster
efs_fs_idefs_kms_key_idencryptedperformance_modeprovisioned_throughputshared_dirthroughput_mode
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

[efs] 部分

定义头节点和计算节点上挂载的 Amazon EFS 的配置设置。有关更多信息，请参阅 Amazon EFS API 参考 中的 CreateFileSystem。

要了解如何在集群定义中包含 Amazon EFS 文件系统，请参阅 [cluster] 部分/efs_settings。

要使用现有的 Amazon EFS 文件系统进行独立于集群生命周期的长期永久性存储，请指定 efs_fs_id。

如果不指定 efs_fs_id，则 Amazon ParallelCluster 会在创建集群时根据 [efs] 设置创建 Amazon EFS 文件系统，并在删除集群时删除该文件系统和数据。

有关更多信息，请参阅 最佳实践：将集群移至新集群 Amazon ParallelCluster 次要版本或补丁版本。

格式为 [efs efs-name]。efs-name 必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (_)。

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

efs_fs_id

（可选）为现有文件系统定义 Amazon EFS 文件系统 ID。

指定此选项将使所有其他 Amazon EFS 选项失效，但 shared_dir 除外。

如果设置此选项，则它仅支持以下类型的文件系统：

  • 堆栈的可用区中没有挂载目标的文件系统。

  • 堆栈的可用区中有一个允许来自 0.0.0.0/0 的入站和出站 NFS 流量的现有挂载目标的文件系统。

用于验证 efs_fs_id 的健全性检查要求 IAM 角色具有以下权限：

  • elasticfilesystem:DescribeMountTargets

  • elasticfilesystem:DescribeMountTargetSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeSecurityGroups

  • ec2:DescribeNetworkInterfaceAttribute

要避免错误，您必须将这些权限添加到您的 IAM 角色或设置 sanity_check = false。

重要

在设置允许来自 0.0.0.0/0 的入站和出站 NFS 流量的挂载目标时，它将使文件系统承受来自挂载目标的可用区中任意位置的 NFS 挂载请求。Amazon 不建议在堆栈的可用区中创建挂载目标，而是让 Amazon 处理这个步骤。如果您想要在堆栈的可用区中拥有挂载目标，请考虑通过在 [vpc] 部分下提供 vpc_security_group_id 选项来使用自定义安全组。然后，将该安全组添加到挂载目标，并关闭 sanity_check 以创建集群。

没有默认值。

efs_fs_id = fs-12345

更新策略：如果更改此设置，则不允许更新。

efs_kms_key_id

（可选）标识用于保护加密文件系统的 Amazon Key Management Service (Amazon KMS) 客户托管密钥。如果设置了此参数，则必须将 encrypted 设置为 true。此参数对应于 Amazon EFS API 参考 中的 KmsKeyId 参数。

没有默认值。

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

更新策略：如果更改此设置，则不允许更新。

encrypted

（可选）指示是否对文件系统加密。此参数对应于 Amazon EFS API 参考 中的 Encrypted 参数。

默认值为 false。

encrypted = true

更新策略：如果更改此设置，则不允许更新。

performance_mode

（可选）定义文件系统的性能模式。此参数对应于 Amazon EFS API 参考 中的 PerformanceMode 参数。

有效选项为以下值：

  • generalPurpose

  • maxIO

这两个值都区分大小写。

对于大多数文件系统，我们推荐使用 generalPurpose 性能模式。

使用 maxIO 性能模式的文件系统可以扩展到更高级别的聚合吞吐量和每秒操作数。但是，对于大多数文件操作来说，代价是稍高的延迟。

创建文件系统后，无法更改此参数。

默认值为 generalPurpose。

performance_mode = generalPurpose

更新策略：如果更改此设置，则不允许更新。

provisioned_throughput

（可选）定义文件系统的预置吞吐量（以 MiB/s 为单位）。此参数对应于 Amazon EFS API 参考 中的 ProvisionedThroughputInMibps 参数。

如果您使用了此参数，则必须将 throughput_mode 设置为 provisioned。

吞吐量配额为 1024 MiB/s。要请求提高配额，请联系 Amazon Web Services Support。

最小值为 0.0 MiB/s。

provisioned_throughput = 1024

更新策略：可以在更新期间更改此设置。

shared_dir

（必需）定义头节点和计算节点上的 Amazon EFS 挂载点。

此参数为必需参数。仅在指定 shared_dir 时使用 Amazon EFS 部分。

请勿使用 NONE 或 /NONE 作为共享目录。

以下示例在 /efs 上挂载 Amazon EFS。

shared_dir = efs

更新策略：如果更改此设置，则不允许更新。

throughput_mode

（可选）定义文件系统的吞吐量模式。此参数对应于 Amazon EFS API 参考 中的 ThroughputMode 参数。

有效选项为以下值：

  • bursting

  • provisioned

默认值为 bursting。

throughput_mode = provisioned

更新策略：可以在更新期间更改此设置。