

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `[ebs]` セクション
<a name="ebs-section"></a>

ヘッドノードにマウントされ、NFS を介してコンピューティングノードに共有されるボリュームの Amazon EBS ボリューム設定を定義します。

クラスター定義に Amazon EBS ボリュームを含める方法については、「``[cluster]` セクション`/``ebs_settings``」を参照してください。

既存の Amazon EBS ボリュームを、クラスターのライフサイクルとは関係なく長期の永続ストレージとして使用するには、[`ebs_volume_id`](#ebs-volume-id) を指定してください。

を指定しない場合[`ebs_volume_id`](#ebs-volume-id)、 はクラスターの作成時に`[ebs]`設定から EBS ボリューム AWS ParallelCluster を作成し、クラスターの削除時にボリュームとデータを削除します。

詳細については、「[ベストプラクティス: AWS ParallelCluster クラスターを新しいマイナーバージョンまたはパッチバージョンに移動する](best-practices.md#best-practices-cluster-upgrades)」を参照してください。

形式は、`[ebs {{ebs-name}}]` です。{{ebs-name}} は、英字で始まり、30 文字以下で、英字、数字、ハイフン (-)、アンダーライン (‗) のみで構成される必要があります。

```
[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`
<a name="ebs-shared-dir"></a>

**(必須)** 共有 Amazon EBS ボリュームをマウントするパスを指定します。

複数の Amazon EBS ボリュームを使用する場合、このパラメータは必須です。

1 つの 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`
<a name="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)

## `ebs_snapshot_id`
<a name="ebs-snapshot-id"></a>

**(オプション)** ボリュームのソースとしてスナップショット ID を使用している場合は、Amazon EBS スナップショット ID を定義します。

デフォルト値はありません。

```
ebs_snapshot_id = {{snap-xxxxx}}
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)

## `ebs_volume_id`
<a name="ebs-volume-id"></a>

**(オプション)** ヘッドノードにアタッチする既存の Amazon EBS ボリュームのボリューム ID を定義します。

デフォルト値はありません。

```
ebs_volume_id = {{vol-xxxxxx}}
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)

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

**(オプション)** Amazon EBS ボリュームが暗号化されているかどうかを指定します。注意: スナップショットでは使用*しない*でください。

デフォルト値は `false` です。

```
encrypted = false
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)

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

**(オプション)** `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` 比率 ＝ 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)

† 最大 IOPS は、32,000 IOPS 以上でプロビジョニングされた [Nitro System で構築されたインスタンス](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)にのみ保証されます。他のインスタンスは、最大 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`
<a name="volume-size"></a>

**(オプション)** 作成するボリュームのサイズ (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
```

**注記**  
 AWS ParallelCluster バージョン 2.10.1 以前は、すべてのボリュームタイプのデフォルト値は 20 GiB でした。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)

## `volume_throughput`
<a name="volume-throughput"></a>

**(オプション)** `gp3` ボリュームタイプのスループットを MiB/秒 で定義します。

デフォルト値は `125` です。

サポートされる値 `volume_throughput` = 125 — 1000 MIB/秒

`volume_throughput` と `volume_iops` の比率は 0.25 以下にします。最大のスループットである 1000 MiB/秒を実現するためには、`volume_iops` の設定を 4000 以上にする必要があります。

```
volume_throughput = 1000
```

**注記**  
 AWS ParallelCluster バージョン 2.10.1 で のサポートが追加され`volume_throughput`ました。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)

## `volume_type`
<a name="volume-type"></a>

**(オプション)** 起動するボリュームの [Amazon EBS ボリュームタイプ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)を指定します。

有効なオプションは次のボリュームタイプです。

`gp2`, `gp3`  
汎用 SSD

`io1`, `io2`  
プロビジョンド IOPS SSD

`st1`  
スループット最適化 HDD

`sc1`  
コールド HDD

`standard`  
前世代のマグネット

詳細については、「Amazon EC2 ユーザーガイド」の「[Amazon EBS ボリュームの種類](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)」を参照してください。

デフォルト値は `gp2` です。

```
volume_type = io2
```

**注記**  
`gp3` および のサポート`io2`が AWS ParallelCluster バージョン 2.10.1 で追加されました。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update.md#update-policy-fail)