Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagian `[efs]`
Mendefinisikan pengaturan konfigurasi untuk Amazon EFS yang dipasang di head dan node komputasi. Untuk informasi selengkapnya, lihat [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)di *Referensi API Amazon EFS*.
Untuk mempelajari cara menyertakan sistem file Amazon EFS dalam definisi cluster Anda, lihat`Bagian `[cluster]``/``efs_settings``.
Untuk menggunakan sistem file Amazon EFS yang ada untuk penyimpanan permanen jangka panjang yang tidak tergantung pada siklus hidup cluster, tentukan[`efs_fs_id`](#efs-efs-fs-id).
Jika Anda tidak menentukan[`efs_fs_id`](#efs-efs-fs-id), AWS ParallelCluster membuat sistem file Amazon EFS dari `[efs]` pengaturan saat membuat cluster dan menghapus sistem file 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`[efs efs-name]`. *efs-name*harus dimulai dengan huruf, berisi tidak lebih dari 30 karakter, dan hanya berisi huruf, angka, tanda hubung (-), dan garis bawah (\$1).
```
[efs customfs]
shared_dir = efs
encrypted = false
performance_mode = generalPurpose
```
**Topics**
+ [`efs_fs_id`](#efs-efs-fs-id)
+ [`efs_kms_key_id`](#efs-efs-kms-key-id)
+ [`encrypted`](#efs-encrypted)
+ [`performance_mode`](#efs-performance-mode)
+ [`provisioned_throughput`](#efs-provisioned-throughput)
+ [`shared_dir`](#efs-shared-dir)
+ [`throughput_mode`](#efs-throughput-mode)
## `efs_fs_id`
**(Opsional)** Mendefinisikan ID sistem file Amazon EFS untuk sistem file yang ada.
Menentukan opsi ini membatalkan semua opsi Amazon EFS lainnya kecuali untuk. [`shared_dir`](cluster-definition.md#cluster-shared-dir)
Jika Anda mengatur opsi ini, itu hanya mendukung jenis sistem file berikut:
+ Sistem file yang tidak memiliki target pemasangan di Availability Zone stack.
+ Sistem file yang memiliki target pemasangan yang ada di Availability Zone stack dengan lalu lintas NFS masuk dan keluar diizinkan. `0.0.0.0/0`
Pemeriksaan kewarasan untuk memvalidasi [`efs_fs_id`](#efs-efs-fs-id) memerlukan peran IAM untuk memiliki izin berikut:
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`
Untuk menghindari kesalahan, Anda harus menambahkan izin ini ke peran IAM Anda, atau mengatur. `sanity_check = false`
**penting**
Saat Anda menetapkan target pemasangan dengan lalu lintas NFS masuk dan keluar yang diizinkan`0.0.0.0/0`, itu akan mengekspos sistem file ke permintaan pemasangan NFS dari mana saja di Availability Zone target mount. AWS tidak merekomendasikan membuat target pemasangan di Availability Zone tumpukan. Sebaliknya, biarkan AWS menangani langkah ini. Jika Anda ingin memiliki target pemasangan di Availability Zone tumpukan, pertimbangkan untuk menggunakan grup keamanan khusus dengan memberikan [`vpc_security_group_id`](vpc-section.md#vpc-security-group-id) opsi di bawah [`[vpc]`bagian](vpc-section.md) tersebut. Kemudian, tambahkan grup keamanan itu ke target mount dan matikan `sanity_check` untuk membuat cluster.
Tidak ada nilai default.
```
efs_fs_id = fs-12345
```
[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)
## `efs_kms_key_id`
**(Opsional)** Mengidentifikasi AWS Key Management Service (AWS KMS) kunci yang dikelola pelanggan yang akan digunakan untuk melindungi sistem file terenkripsi. Jika ini diatur, [`encrypted`](#efs-encrypted) pengaturan harus diatur ke`true`. Ini sesuai dengan [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId)parameter di *Referensi API Amazon EFS*.
Tidak ada nilai default.
```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```
[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**(Opsional)** Menunjukkan apakah sistem file dienkripsi. Ini sesuai dengan parameter [Terenkripsi](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) di Referensi Amazon *EFS API*.
Nilai default-nya adalah `false`.
```
encrypted = true
```
[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)
## `performance_mode`
**(Opsional)** Mendefinisikan mode kinerja sistem file. Ini sesuai dengan [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode)parameter di *Referensi API Amazon EFS*.
Opsi yang valid adalah nilai-nilai berikut:
+ `generalPurpose`
+ `maxIO`
Kedua nilai tersebut peka huruf besar/kecil.
Kami merekomendasikan mode `generalPurpose` kinerja untuk sebagian besar sistem file.
Sistem file yang menggunakan mode `maxIO` kinerja dapat menskalakan ke tingkat throughput agregat dan operasi per detik yang lebih tinggi. Namun, ada trade-off latensi yang sedikit lebih tinggi untuk sebagian besar operasi file.
Setelah sistem file dibuat, parameter ini tidak dapat diubah.
Nilai default-nya adalah `generalPurpose`.
```
performance_mode = generalPurpose
```
[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)
## `provisioned_throughput`
**(Opsional)** Mendefinisikan throughput yang disediakan dari sistem file, diukur dalam MIB/s. Ini sesuai dengan [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps)parameter di *Referensi API Amazon EFS*.
Jika Anda menggunakan parameter ini, Anda harus mengatur [`throughput_mode`](#efs-throughput-mode) ke`provisioned`.
Kuota pada throughput adalah `1024` MIB/s. Untuk meminta kenaikan kuota, hubungi Dukungan.
Nilai minimum adalah `0.0` MIB/s.
```
provisioned_throughput = 1024
```
[Kebijakan pembaruan: Pengaturan ini dapat diubah selama pembaruan.](using-pcluster-update.md#update-policy-setting-supported)
## `shared_dir`
**(Wajib)** Mendefinisikan titik pemasangan Amazon EFS di head dan node komputasi.
Parameter ini diperlukan. Bagian Amazon EFS hanya digunakan jika [`shared_dir`](cluster-definition.md#cluster-shared-dir) ditentukan.
Jangan gunakan `NONE` atau `/NONE` sebagai direktori bersama.
Contoh berikut memasang Amazon EFS di`/efs`.
```
shared_dir = efs
```
[Kebijakan pembaruan: Jika pengaturan ini diubah, pembaruan tidak diizinkan.](using-pcluster-update.md#update-policy-fail)
## `throughput_mode`
**(Opsional)** Mendefinisikan mode throughput dari sistem file. Ini sesuai dengan [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode)parameter di *Referensi API Amazon EFS*.
Opsi yang valid adalah nilai-nilai berikut:
+ `bursting`
+ `provisioned`
Nilai default-nya adalah `bursting`.
```
throughput_mode = provisioned
```
[Kebijakan pembaruan: Pengaturan ini dapat diubah selama pembaruan.](using-pcluster-update.md#update-policy-setting-supported)