本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `[ebs]` 區段
定義掛載在前端節點上並透過 NFS 與運算節點共用之磁碟區的 Amazon EBS 磁碟區組態設定。
若要了解如何在叢集定義中包含 Amazon EBS 磁碟區，請參閱 ``[cluster]` 區段` / ``ebs_settings``。
若要將現有的 Amazon EBS 磁碟區用於與叢集生命週期無關的長期永久儲存，請指定 [`ebs_volume_id`](#ebs-volume-id)。
如果您未指定 [`ebs_volume_id`](#ebs-volume-id)， 會在建立叢集時從`[ebs]`設定 AWS ParallelCluster 建立 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 磁碟區[`shared_dir`](cluster-definition.md#cluster-shared-dir)時，此選項會覆寫 [`[cluster]`區段](cluster-definition.md)下指定的 。在下列範例中，磁碟區會掛載至 `/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_iops``volume_size`比率因 [`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`比率 = 每個 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 = 200
```
[更新政策：此設定可以在更新期間變更。](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。除非您[修改磁碟區](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html)，否則舊版磁碟`io1`區可能無法達到完整效能。 `io2`Block Express 磁碟區支援高達 256，000 `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`](#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`
**（選用）** 指定您要啟動之[磁碟區的 Amazon EBS 磁碟區類型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)。
有效選項包括下列磁碟區類型：
`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)