

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Bagian `[ebs]`
<a name="ebs-section"></a>

Mendefinisikan pengaturan konfigurasi volume Amazon EBS untuk volume yang dipasang pada node kepala dan dibagikan ke node komputasi melalui NFS.

Untuk mempelajari cara menyertakan volume Amazon EBS dalam definisi klaster Anda, lihat`Bagian `[cluster]``/``ebs_settings``.

Untuk menggunakan volume Amazon EBS yang ada untuk penyimpanan permanen jangka panjang yang tidak tergantung pada siklus hidup klaster, tentukan[`ebs_volume_id`](#ebs-volume-id).

Jika Anda tidak menentukan[`ebs_volume_id`](#ebs-volume-id), AWS ParallelCluster buat volume EBS dari `[ebs]` pengaturan saat membuat cluster dan menghapus volume dan data saat cluster dihapus.

Untuk informasi selengkapnya, lihat [Praktik terbaik: memindahkan cluster ke versi AWS ParallelCluster minor atau patch baru](best-practices.md#best-practices-cluster-upgrades).

Formatnya adalah`[ebs ebs-name]`. *ebs-name*harus dimulai dengan huruf, berisi tidak lebih dari 30 karakter, dan hanya berisi huruf, angka, tanda hubung (-), dan garis bawah (\$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`
<a name="ebs-shared-dir"></a>

**(Wajib)** Menentukan jalur tempat volume Amazon EBS bersama dipasang.

Parameter ini diperlukan saat menggunakan beberapa volume Amazon EBS.

[Saat Anda menggunakan satu volume Amazon EBS, opsi ini akan menimpa volume [`shared_dir`](cluster-definition.md#cluster-shared-dir) yang ditentukan di bawah bagian`[cluster]`.](cluster-definition.md) Dalam contoh berikut, volume dipasang ke`/vol1`.

```
shared_dir = vol1
```

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

## `ebs_kms_key_id`
<a name="ebs-kms-key-id"></a>

**(Opsional)** Menentukan AWS KMS kunci kustom untuk digunakan untuk enkripsi.

Parameter ini harus digunakan bersama dengan`encrypted = true`. Itu juga harus memiliki kebiasaan[`ec2_iam_role`](cluster-definition.md#ec2-iam-role).

Untuk informasi selengkapnya, lihat [Enkripsi disk dengan Kunci KMS khusus](tutorials_04_encrypted_kms_fs.md).

```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Mendefinisikan ID snapshot Amazon EBS jika Anda menggunakan snapshot sebagai sumber volume.

Tidak ada nilai default.

```
ebs_snapshot_id = snap-xxxxx
```

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Mendefinisikan ID volume volume Amazon EBS yang ada untuk dilampirkan ke node kepala.

Tidak ada nilai default.

```
ebs_volume_id = vol-xxxxxx
```

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Menentukan apakah volume Amazon EBS dienkripsi. Catatan: *Jangan* gunakan dengan snapshot.

Nilai default-nya adalah `false`.

```
encrypted = false
```

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Mendefinisikan jumlah IOPS untuk`io1`,`io2`, dan `gp3` jenis volume.

Nilai default, nilai yang didukung, dan `volume_iops` `volume_size` rasio bervariasi menurut [`volume_type`](raid-section.md#raid-volume-type) dan[`volume_size`](#volume-size).

`volume_type` = `io1`  
Default `volume_iops` = 100  
Nilai yang didukung `volume_iops` = 100—64000 †  
Maksimum `volume_iops` terhadap `volume_size` rasio = 50 IOPS untuk setiap GiB. 5000 IOPS membutuhkan `volume_size` setidaknya 100 GiB.

`volume_type` = `io2`  
Default `volume_iops` = 100  
Nilai yang didukung `volume_iops` = 100—64000 (256000 untuk `io2` volume Block Express) †  
`volume_size`Rasio maksimum `volume_iops` = 500 IOPS untuk setiap GiB. 5000 IOPS membutuhkan `volume_size` minimal 10 GiB.

`volume_type` = `gp3`  
Default `volume_iops` = 3000  
Nilai yang didukung `volume_iops` = 3000—16000  
`volume_size`Rasio maksimum `volume_iops` = 500 IOPS untuk setiap GiB. 5000 IOPS membutuhkan `volume_size` minimal 10 GiB.

```
volume_iops = 200
```

[Kebijakan pembaruan: Pengaturan ini dapat diubah selama pembaruan.](using-pcluster-update.md#update-policy-setting-supported)

† IOPS maksimum dijamin hanya pada [Instans yang dibangun di atas Sistem Nitro yang](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) disediakan dengan lebih dari 32.000 IOPS. Instans lain menjamin hingga 32.000 IOPS. Kecuali Anda [memodifikasi volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html), `io1` volume sebelumnya mungkin tidak mencapai kinerja penuh. `io2` Volume Block Express mendukung `volume_iops` nilai hingga 256.000. Untuk informasi selengkapnya, lihat [`io2`Blokir volume Express (Dalam pratinjau)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express) di *Panduan EC2 Pengguna Amazon*.

## `volume_size`
<a name="volume-size"></a>

**(Opsional)** Menentukan ukuran volume yang akan dibuat, di GiB (jika Anda tidak menggunakan snapshot).

Nilai default dan nilai yang didukung bervariasi menurut nilai[`volume_type`](#volume-type).

`volume_type` = `standard`  
Default `volume_size` = 20 GiB  
Nilai yang didukung `volume_size` = 1-1024 GiB

`volume_type`=`gp2`,`io1`,`io2`, dan `gp3`  
Default `volume_size` = 20 GiB  
Nilai yang didukung `volume_size` = 1-16384 GiB

`volume_type`= `sc1` dan `st1`  
Default `volume_size` = 500 GiB  
Nilai yang didukung `volume_size` = 500—16384 GiB

```
volume_size = 20
```

**catatan**  
Sebelum AWS ParallelCluster versi 2.10.1, nilai default untuk semua jenis volume adalah 20 GiB.

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Mendefinisikan throughput untuk tipe `gp3` volume, dalam MIB/s.

Nilai default-nya adalah `125`.

Nilai yang didukung `volume_throughput` = 125—1000 MiB/s

Rasio `volume_throughput` to `volume_iops` bisa tidak lebih dari 0,25. Throughput maksimum 1000 MiB/s mengharuskan `volume_iops` pengaturan setidaknya 4000.

```
volume_throughput = 1000
```

**catatan**  
Support untuk `volume_throughput` ditambahkan di AWS ParallelCluster versi 2.10.1.

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)

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

**(Opsional)** Menentukan [jenis volume Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) dari volume yang ingin Anda luncurkan.

Opsi yang valid adalah jenis volume berikut:

`gp2`, `gp3`  
SSD tujuan umum

`io1`, `io2`  
SSD IOPS Terprovisi

`st1`  
Throughput HDD yang dioptimalkan

`sc1`  
Cold HDD

`standard`  
Magnetik generasi sebelumnya

Untuk informasi selengkapnya, lihat [Jenis volume Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) di *Panduan EC2 Pengguna Amazon*.

Nilai default-nya adalah `gp2`.

```
volume_type = io2
```

**catatan**  
Support untuk `gp3` dan `io2` ditambahkan dalam AWS ParallelCluster versi 2.10.1.

[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)