本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `[raid]` 區段
定義從多個相同 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`
**（必要）** 定義前端和運算節點上 RAID 陣列的掛載點。
只在指定此參數時，才會建立 RAID 磁碟機。
請勿使用 `NONE`或 `/NONE`做為共用目錄。
以下範例會在 `/raid` 掛載陣列。
```
shared_dir = raid
```
[更新政策：如果變更此設定，則不允許更新。](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)
## `encrypted`
**（選用）** 指定檔案系統是否已加密。
預設值為 `false`。
```
encrypted = false
```
[更新政策：如果變更此設定，則不允許更新。](using-pcluster-update.md#update-policy-fail)
## `num_of_raid_volumes`
**（選用）** 定義要從中組合 RAID 陣列的 Amazon EBS 磁碟區數量。
磁碟區數量下限為 `2`。
磁碟區數量上限為 `5`。
預設值為 `2`。
```
num_of_raid_volumes = 2
```
[更新政策：如果變更此設定，則不允許更新。](using-pcluster-update.md#update-policy-fail)
## `raid_type`
**（必要）** 定義 RAID 陣列的 RAID 類型。
只在指定此參數時，才會建立 RAID 磁碟機。
有效選項為下列值：
+ `0`
+ `1`
如需 RAID 類型的詳細資訊，請參閱《*Amazon 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`
**（選用）** 定義 `io1`、 `io2`和`gp3`類型磁碟區的 IOPS 數量。
預設值、支援的值和`volume_iops``volume_size`比率因 [`volume_type`](#raid-volume-type)和 而異[`volume_size`](#raid-volume-size)。
`volume_type` = `io1`
預設值 `volume_iops` = 100
支援的值 `volume_iops` = 100–64000 †
最大`volume_iops``volume_size`比率 = 每 GiB 50 IOPS。5000 IOPS 需要至少 100 GiB `volume_size`的 。
`volume_type` = `io2`
預設值 `volume_iops` = 100
支援的值 `volume_iops` = 100–64000 (`io2`區塊快速磁碟區為 256000) †
最大`volume_iops``volume_size`比率 = 每 GiB 500 IOPS。5000 IOPS 需要至少 10 GiB `volume_size`的 。
`volume_type` = `gp3`
預設值 `volume_iops` = 3000
支援的值 `volume_iops` = 3000–16000
最大`volume_iops``volume_size`比率 = 每 GiB 500 IOPS。5000 IOPS 需要至少 10 GiB `volume_size`的 。
```
volume_iops = 3000
```
[更新政策：此設定可以在更新期間變更。](using-pcluster-update.md#update-policy-setting-supported)
† 只有建置在[佈建超過 32，000 IOPS 的 Nitro 系統上的執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)，才能保證 IOPS 上限。其他執行個體保證高達 32，000 IOPS。除非您修改`io1`磁碟區，否則較舊的磁碟區可能無法達到完整效能。 [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html) `io2`Block Express 磁碟區支援高達 256000 `volume_iops`的值。如需詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的 [`io2` Block Express 磁碟區 （預覽中）](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express)。
## `volume_size`
**（選用）** 以 GiB 定義要建立的磁碟區大小。
預設值和支援的值因 而異[`volume_type`](#raid-volume-type)。
`volume_type` = `standard`
預設 `volume_size` = 20 GiB
支援的值 `volume_size` = 1–1024 GiB
`volume_type` = `gp2`、`io2`、 `io1`和 `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`
**（選用）** 以 MiB/s 為單位定義`gp3`磁碟區類型的輸送量。
預設值為 `125`。
支援的值 `volume_throughput` = 125–1000 MiB/s
`volume_throughput` 與 的比率`volume_iops`不可超過 0.25。1000 MiB/s 的最大輸送量要求`volume_iops`設定至少為 4000。
```
volume_throughput = 1000
```
**注意**
`volume_throughput` 2.10.1 AWS ParallelCluster 版已新增 的支援。
[更新政策：如果變更此設定，則不允許更新。](using-pcluster-update.md#update-policy-fail)
## `volume_type`
**（選用）** 定義要建置的磁碟區類型。
有效選項為下列值：
`gp2`, `gp3`
一般用途 SSD
`io1`, `io2`
Provisioned IOPS SSD
`st1`
輸送量最佳化 HDD
`sc1`
Cold HDD
`standard`
上一代磁性
如需詳細資訊，請參閱《Amazon EC2 使用者指南》中的 [Amazon EBS 磁碟區類型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)。
預設值為 `gp2`。
```
volume_type = io2
```
**注意**
2.10.1 AWS ParallelCluster 版已`io2`新增 `gp3`和 的支援。
[更新政策：如果變更此設定，則不允許更新。](using-pcluster-update.md#update-policy-fail)