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

# `[raid]` 部分
<a name="raid-section"></a>

定义通过多个完全相同的 Amazon EBS 卷构建的 RAID 阵列的配置设置。RAID 驱动器挂载到头节点上并通过 NFS 导出到计算节点。

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

```
[raid rs]
shared_dir = raid
raid_type = 1
num_of_raid_volumes = 2
encrypted = true
```

**Topics**
+ [

## `shared_dir`
](#raid-shared-dir)
+ [

## `ebs_kms_key_id`
](#raid-ebs_kms_key_id)
+ [

## `encrypted`
](#raid-encrypted)
+ [

## `num_of_raid_volumes`
](#num-of-raid-volumes)
+ [

## `raid_type`
](#raid-type)
+ [

## `volume_iops`
](#raid-volume-iops)
+ [

## `volume_size`
](#raid-volume-size)
+ [

## `volume_throughput`
](#raid-volume-throughput)
+ [

## `volume_type`
](#raid-volume-type)

## `shared_dir`
<a name="raid-shared-dir"></a>

**（必需）**定义头节点和计算节点上 RAID 阵列的挂载点。

仅在指定此参数时创建 RAID 驱动器。

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

以下示例在 `/raid` 上挂载阵列。

```
shared_dir = raid
```

[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)

## `ebs_kms_key_id`
<a name="raid-ebs_kms_key_id"></a>

**（可选）**指定用于加密的自定义密 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)

## `encrypted`
<a name="raid-encrypted"></a>

**（可选）**指定是否对文件系统加密。

默认值为 `false`。

```
encrypted = false
```

[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)

## `num_of_raid_volumes`
<a name="num-of-raid-volumes"></a>

**（可选）**定义用于组装 RAID 阵列的 Amazon EBS 卷数。

最小卷数为 `2`。

最大卷数为 `5`。

默认值为 `2`。

```
num_of_raid_volumes = 2
```

[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)

## `raid_type`
<a name="raid-type"></a>

**（必需）**定义 RAID 阵列的 RAID 类型。

仅在指定此参数时创建 RAID 驱动器。

有效选项为以下值：
+ `0`
+ `1`

有关 RAID 类型的更多信息，请参阅《*亚马逊 EC2 用户指南*》中的 [RAID 信息](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/raid-config.html)。

以下示例创建 RAID `0` 阵列：

```
raid_type = 0
```

[更新策略：如果更改此设置，则不允许更新。](using-pcluster-update.md#update-policy-fail)

## `volume_iops`
<a name="raid-volume-iops"></a>

**（可选）**为 `io1`、`io2` 和 `gp3` 类型卷定义 IOPS 数。

默认值、支持的值以及 `volume_size`/`volume_iops` 比率因 [`volume_type`](#raid-volume-type) 和 [`volume_size`](#raid-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 = 3000
```

[更新策略：可以在更新期间更改此设置。](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`
<a name="raid-volume-size"></a>

**（可选）**定义要创建的卷的大小，以 GiB 为单位。

默认值和支持的值因 [`volume_type`](#raid-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`
<a name="raid-volume-throughput"></a>

**（可选）**定义 `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`
<a name="raid-volume-type"></a>

**（可选）**定义要构建的卷的类型。

有效选项为以下值：

`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)