本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `[ebs]` 部分
定义头节点上挂载且通过 NFS 共享到计算节点的卷的 Amazon EBS 卷配置设置。
要了解如何在集群定义中包含 Amazon EBS 卷，请参阅 ``[cluster]` 部分`/``ebs_settings``。
要将现有的 Amazon EBS 卷用于独立于集群生命周期的长期永久性存储，请指定 [`ebs_volume_id`](#ebs-volume-id)。
如果您未指定[`ebs_volume_id`](#ebs-volume-id)，则在 AWS ParallelCluster 创建集群时根据`[ebs]`设置创建 EBS 卷，并在删除集群时删除该卷和数据。
有关更多信息，请参阅 [最佳实践：将集群移至新的 AWS ParallelCluster 次要版本或补丁版本](best-practices.md#best-practices-cluster-upgrades)。
格式为`[ebs ebs-name]`。 *ebs-name*必须以字母开头，不能超过 30 个字符，并且只能包含字母、数字、连字符 (-) 和下划线 (\$1)。
```
[ebs custom1]
shared_dir = vol1
ebs_snapshot_id = snap-xxxxx
volume_type = io1
volume_iops = 200
...
[ebs custom2]
shared_dir = vol2
...
...
```
**Topics**
+ [`shared_dir`](#ebs-shared-dir)
+ [`ebs_kms_key_id`](#ebs-kms-key-id)
+ [`ebs_snapshot_id`](#ebs-snapshot-id)
+ [`ebs_volume_id`](#ebs-volume-id)
+ [`encrypted`](#encrypted)
+ [`volume_iops`](#volume-iops)
+ [`volume_size`](#volume-size)
+ [`volume_throughput`](#volume-throughput)
+ [`volume_type`](#volume-type)
## `shared_dir`
**（必需）**指定在其中挂载共享 Amazon EBS 卷的路径。
使用多个 Amazon EBS 卷时需要此参数。
当使用一个 Amazon EBS 卷时，此选项将覆盖在 [`[cluster]` 部分](cluster-definition.md)下指定的 [`shared_dir`](cluster-definition.md#cluster-shared-dir)。在以下示例中，卷将挂载到 `/vol1`。
```
shared_dir = vol1
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `ebs_kms_key_id`
**（可选）**指定用于加密的自定义密 AWS KMS 钥。
此参数必须与 `encrypted = true` 一起使用。它还必须具有自定义 [`ec2_iam_role`](cluster-definition.md#ec2-iam-role)。
有关更多信息，请参阅 [使用自定义 KMS 密钥对磁盘加密](tutorials_04_encrypted_kms_fs.md)。
```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `ebs_snapshot_id`
**（可选）**如果将快照用作卷的源，则定义 Amazon EBS 快照 ID。
没有默认值。
```
ebs_snapshot_id = snap-xxxxx
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `ebs_volume_id`
**（可选）**定义要附加到头节点的现有 Amazon EBS 卷的卷 ID。
没有默认值。
```
ebs_volume_id = vol-xxxxxx
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**（可选）**指定是否加密 Amazon EBS 卷。注意：请*勿* 使用快照。
默认值为 `false`。
```
encrypted = false
```
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `volume_iops`
**（可选）**为 `io1`、`io2` 和 `gp3` 类型卷定义 IOPS 数。
默认值、支持的值以及 `volume_size`/`volume_iops` 比率因 [`volume_type`](raid-section.md#raid-volume-type) 和 [`volume_size`](#volume-size) 而异。
`volume_type` = `io1`
默认值：`volume_iops` = 100
支持的值：`volume_iops` = 100–64000 †
最大 `volume_iops`/`volume_size` 比率 = 50 IOPS/GiB。5000 IOPS 需要至少 100 GiB 的 `volume_size`。
`volume_type` = `io2`
默认值：`volume_iops` = 100
支持的值：`volume_iops` = 100–64000（`io2` Block Express 卷为 256000）†
最大 `volume_iops`/`volume_size` 比率 = 500 IOPS/GiB。5000 IOPS 需要至少 10 GiB 的 `volume_size`。
`volume_type` = `gp3`
默认值：`volume_iops` = 3000
支持的值：`volume_iops` = 3000–16000
最大 `volume_iops`/`volume_size` 比率 = 500 IOPS/GiB。5000 IOPS 需要至少 10 GiB 的 `volume_size`。
```
volume_iops = 200
```
[更新策略：可以在更新期间更改此设置。](using-pcluster-update.md#update-policy-setting-supported)
† 只有[在 Nitro System 上构建的实例](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)配置超过 32000 IOPS 时，才能保证最大 IOPS。其他实例保证最高为 32000 IOPS。除非您[修改卷](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html)，否则较早的 `io1` 卷可能无法实现完全性能。`io2`Block Express 卷支持高达 256000 的 `volume_iops` 值。有关更多信息，请参阅《*亚马逊 EC2 用户指南》*[中的 “`io2`屏蔽 Express 卷（预览版）](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express)”。
## `volume_size`
**（可选）**指定要创建的卷的大小，以 GiB 为单位（如果未使用快照）。
默认值和支持的值因 [`volume_type`](#volume-type) 而异。
`volume_type` = `standard`
默认值：`volume_size` = 20 GiB
支持的值：`volume_size` = 1–1024 GiB
`volume_type` = `gp2`、`io1`、`io2` 和 `gp3`
默认值：`volume_size` = 20 GiB
支持的值：`volume_size` = 1–16384 GiB
`volume_type` = `sc1` 和 `st1`
默认值：`volume_size` = 500 GiB
支持的值：`volume_size` = 500–16384 GiB
```
volume_size = 20
```
**注意**
在 2.10.1 AWS ParallelCluster 版本之前，所有卷类型的默认值均为 20 GiB。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `volume_throughput`
**（可选）**定义 `gp3` 卷类型的吞吐量，以 MiB/s 为单位。
默认值为 `125`。
支持的值：`volume_throughput` = 125–1000 MiB/s
`volume_throughput` 与 `volume_iops` 的比率不能超过 0.25。1000 MiB/s 的最大吞吐量要求 `volume_iops` 设置至少为 4000。
```
volume_throughput = 1000
```
**注意**
在 2.10.1 AWS ParallelCluster 版本中增加了对 Support 的支持。`volume_throughput`
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)
## `volume_type`
**（可选）**指定要启动的卷的 [Amazon EBS 卷类型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)。
有效选项为以下卷类型：
`gp2`, `gp3`
通用型 SSD
`io1`, `io2`
预调配 IOPS SSD
`st1`
吞吐量优化型 HDD
`sc1`
Cold HDD
`standard`
上一代磁介质
有关更多信息，请参阅《[亚马逊* EC2 用户指南》中的 Amaz* on EBS 卷类型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)。
默认值为 `gp2`。
```
volume_type = io2
```
**注意**
在 2.10.1 AWS ParallelCluster 版本中增加了对`gp3`和`io2`的支持。
[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)