

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Sezione `[efs]`


Definisce le impostazioni di configurazione per Amazon EFS montato sui nodi principali e di calcolo. Per ulteriori informazioni, [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)consulta *Amazon EFS API Reference*.

Per informazioni su come includere i file system Amazon EFS nella definizione del cluster, consulta`Sezione `[cluster]``/``efs_settings``.

Per utilizzare un file system Amazon EFS esistente per lo storage permanente a lungo termine indipendente dal ciclo di vita del cluster, specifica[`efs_fs_id`](#efs-efs-fs-id).

Se non lo specifichi[`efs_fs_id`](#efs-efs-fs-id), AWS ParallelCluster crea il file system Amazon EFS dalle `[efs]` impostazioni al momento della creazione del cluster ed elimina il file system e i dati quando il cluster viene eliminato.

Per ulteriori informazioni, consulta [Procedure consigliate: spostare un cluster a una nuova AWS ParallelCluster versione secondaria o patch](best-practices.md#best-practices-cluster-upgrades).

Il formato è`[efs efs-name]`. *efs-name*deve iniziare con una lettera, non contenere più di 30 caratteri e contenere solo lettere, numeri, trattini (-) e caratteri di sottolineatura (\$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`


**(Facoltativo)** Definisce l'ID del file system Amazon EFS per un file system esistente.

La specifica di questa opzione annulla tutte le altre opzioni di Amazon EFS ad eccezione di. [`shared_dir`](cluster-definition.md#cluster-shared-dir)

Se imposti questa opzione, supporta solo i seguenti tipi di file system:
+ File system che non hanno una destinazione di montaggio nella zona di disponibilità dello stack.
+ File system con una destinazione di montaggio esistente nella zona di disponibilità dello stack da cui è consentito il traffico NFS in entrata e in uscita da. `0.0.0.0/0`

La verifica dell'integrità per la convalida di [`efs_fs_id`](#efs-efs-fs-id) richiede le autorizzazioni seguenti per il ruolo IAM:
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`

Per evitare errori, aggiungi queste autorizzazioni al ruolo IAM o imposta `sanity_check = false`.

**Importante**  
Quando si imposta una destinazione di montaggio da cui è consentito il traffico NFS in entrata e in uscita`0.0.0.0/0`, il file system viene esposto alle richieste di montaggio NFS provenienti da qualsiasi punto della zona di disponibilità del target di montaggio. AWS non consiglia di creare un target di montaggio nella zona di disponibilità dello stack. Invece, lascia che AWS gestisca questo passaggio. Se desideri avere un target di montaggio nella zona di disponibilità dello stack, prendi in considerazione l'utilizzo di un gruppo di sicurezza personalizzato fornendo un'[`vpc_security_group_id`](vpc-section.md#vpc-security-group-id)opzione nella [`[vpc]`sezione](vpc-section.md). Quindi, aggiungi quel gruppo di sicurezza alla destinazione di montaggio e disattivalo `sanity_check` per creare il cluster.

Non c'è alcun valore predefinito.

```
efs_fs_id = fs-12345
```

[Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update.md#update-policy-fail)

## `efs_kms_key_id`


**(Facoltativo)** Identifica la AWS Key Management Service (AWS KMS) chiave gestita dal cliente da utilizzare per proteggere il file system crittografato. Se è impostata, [`encrypted`](#efs-encrypted) deve essere `true`. Corrisponde al [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId)parametro nell'*Amazon EFS API Reference*.

Non c'è alcun valore predefinito.

```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```

[Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update.md#update-policy-fail)

## `encrypted`


**(Facoltativo)** Indica se il file system è crittografato. Corrisponde al parametro [Encrypted](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) nell'*Amazon EFS API Reference*.

Il valore predefinito è `false`.

```
encrypted = true
```

[Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update.md#update-policy-fail)

## `performance_mode`


**(Facoltativo)** Definisce la modalità di prestazioni del file system. Corrisponde al [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode)parametro nell'*Amazon EFS API Reference*.

Le opzioni valide sono i seguenti valori:
+ `generalPurpose`
+ `maxIO`

 Entrambi i valori distinguono tra maiuscole e minuscole.

Consigliamo la Modalità performance `generalPurpose` per la maggior parte dei file system.

I file system che utilizzano la Modalità performance `maxIO` sono in grado di scalare a livelli più elevati di throughput aggregato e operazioni al secondo. Tuttavia, esiste un compromesso tra latenze leggermente superiori per la maggior parte delle operazioni sui file.

Dopo la creazione del file system, questo parametro non può essere modificato.

Il valore predefinito è `generalPurpose`.

```
performance_mode = generalPurpose
```

[Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update.md#update-policy-fail)

## `provisioned_throughput`


**(Facoltativo)** Definisce la velocità effettiva assegnata al file system, misurata in MiB/s. Corrisponde al [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps)parametro nell'*Amazon EFS API Reference*.

Se si utilizza questo parametro, è necessario impostare [`throughput_mode`](#efs-throughput-mode) su `provisioned`.

La quota di throughput è di `1024` MiB/s. Per richiedere un aumento delle quote, contattare Supporto.

Il valore minimo è `0.0` MiB/s.

```
provisioned_throughput = 1024
```

[Politica di aggiornamento: questa impostazione può essere modificata durante un aggiornamento.](using-pcluster-update.md#update-policy-setting-supported)

## `shared_dir`


**(Obbligatorio)** Definisce il punto di montaggio di Amazon EFS sui nodi principali e di calcolo.

Questo parametro è obbligatorio. La sezione Amazon EFS viene utilizzata solo se [`shared_dir`](cluster-definition.md#cluster-shared-dir) specificata.

Non utilizzare `NONE` or `/NONE` come directory condivisa.

L'esempio seguente monta Amazon EFS su`/efs`.

```
shared_dir = efs
```

[Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update.md#update-policy-fail)

## `throughput_mode`


**(Facoltativo)** Definisce la modalità di trasmissione del file system. Corrisponde al [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode)parametro nell'*Amazon EFS API Reference*.

Le opzioni valide sono i seguenti valori:
+ `bursting`
+ `provisioned`

Il valore predefinito è `bursting`.

```
throughput_mode = provisioned
```

[Politica di aggiornamento: questa impostazione può essere modificata durante un aggiornamento.](using-pcluster-update.md#update-policy-setting-supported)