Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# `[efs]` Section
Définit les paramètres de configuration pour l'Amazon EFS monté sur les nœuds de tête et de calcul. Pour plus d'informations, consultez [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)le manuel *Amazon EFS API Reference*.
Pour savoir comment inclure les systèmes de fichiers Amazon EFS dans la définition de votre cluster, consultez``[cluster]` Section`/``efs_settings``.
Pour utiliser un système de fichiers Amazon EFS existant pour un stockage permanent à long terme indépendant du cycle de vie du cluster, spécifiez[`efs_fs_id`](#efs-efs-fs-id).
Si vous ne le spécifiez pas[`efs_fs_id`](#efs-efs-fs-id), AWS ParallelCluster crée le système de fichiers Amazon EFS à partir des `[efs]` paramètres lors de la création du cluster et supprime le système de fichiers et les données lorsque le cluster est supprimé.
Pour de plus amples informations, veuillez consulter [Bonnes pratiques : déplacement d'un cluster vers une nouvelle version AWS ParallelCluster mineure ou un correctif](best-practices.md#best-practices-cluster-upgrades).
Le format est`[efs efs-name]`. *efs-name*doit commencer par une lettre, ne pas contenir plus de 30 caractères et contenir uniquement des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (\$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`
**(Facultatif)** Définit l'ID du système de fichiers Amazon EFS pour un système de fichiers existant.
La spécification de cette option annule toutes les autres options Amazon EFS, à l'exception de[`shared_dir`](cluster-definition.md#cluster-shared-dir).
Si vous définissez cette option, elle ne prend en charge que les types de systèmes de fichiers suivants :
+ Systèmes de fichiers qui n'ont pas de cible de montage dans la zone de disponibilité de la pile.
+ Systèmes de fichiers dotés d'une cible de montage existante dans la zone de disponibilité de la pile et dont le trafic NFS entrant et sortant est autorisé à partir de. `0.0.0.0/0`
La vérification d'intégrité pour valider [`efs_fs_id`](#efs-efs-fs-id) exige que le rôle IAM dispose des autorisations suivantes :
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`
Veuillez ajouter ces autorisations à votre rôle IAM ou définissez `sanity_check = false` pour éviter les erreurs.
**Important**
Lorsque vous définissez une cible de montage dont le trafic NFS entrant et sortant est autorisé`0.0.0.0/0`, le système de fichiers est exposé aux demandes de montage NFS provenant de n'importe quel endroit de la zone de disponibilité de la cible de montage. AWS ne recommande pas de créer une cible de montage dans la zone de disponibilité de la pile. Laissons plutôt cette étape s' AWS occuper de cette étape. Si vous souhaitez avoir une cible de montage dans la zone de disponibilité de la pile, pensez à utiliser un groupe de sécurité personnalisé en fournissant une [`vpc_security_group_id`](vpc-section.md#vpc-security-group-id) option dans la [`[vpc]`section](vpc-section.md). Ajoutez ensuite ce groupe de sécurité à la cible de montage et désactivez-le `sanity_check` pour créer le cluster.
Il n'existe aucune valeur par défaut.
```
efs_fs_id = fs-12345
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `efs_kms_key_id`
**(Facultatif)** Identifie la clé gérée par le client AWS Key Management Service (AWS KMS) à utiliser pour protéger le système de fichiers chiffré. Si ce paramètre est défini, le paramètre [`encrypted`](#efs-encrypted) doit être défini sur `true`. Cela correspond au [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId)paramètre indiqué dans le manuel *Amazon EFS API Reference*.
Il n'existe aucune valeur par défaut.
```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**(Facultatif)** Indique si le système de fichiers est crypté. Cela correspond au paramètre [Encrypted](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) dans la *référence d'API Amazon EFS*.
La valeur par défaut est `false`.
```
encrypted = true
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `performance_mode`
**(Facultatif)** Définit le mode de performance du système de fichiers. Cela correspond au [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode)paramètre indiqué dans le manuel *Amazon EFS API Reference*.
Les options valides sont les valeurs suivantes :
+ `generalPurpose`
+ `maxIO`
Les deux valeurs distinguent les majuscules et minuscules.
Nous recommandons le mode de performance `generalPurpose` pour la plupart des systèmes de fichiers.
Les systèmes de fichiers qui utilisent le mode de performance `maxIO` peuvent évoluer vers des niveaux plus élevés de débit cumulé et d'opérations par seconde. Cependant, il existe un compromis entre des latences légèrement plus élevées pour la plupart des opérations sur les fichiers.
Une fois le système de fichiers créé, ce paramètre ne peut pas être modifié.
La valeur par défaut est `generalPurpose`.
```
performance_mode = generalPurpose
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `provisioned_throughput`
**(Facultatif)** Définit le débit provisionné du système de fichiers, mesuré en Mbits/s. Cela correspond au [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps)paramètre indiqué dans le manuel *Amazon EFS API Reference*.
Si vous utilisez ce paramètre, vous devez définir [`throughput_mode`](#efs-throughput-mode) sur `provisioned`.
Le quota de débit est de `1024` Mbits/s. Pour demander une augmentation de quota, contactez Support.
La valeur minimale est `0.0` MiO/s.
```
provisioned_throughput = 1024
```
[Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.](using-pcluster-update.md#update-policy-setting-supported)
## `shared_dir`
**(Obligatoire)** Définit le point de montage Amazon EFS sur la tête et les nœuds de calcul.
Ce paramètre est obligatoire. La section Amazon EFS n'est utilisée que si elle [`shared_dir`](cluster-definition.md#cluster-shared-dir) est spécifiée.
N'utilisez pas `NONE` ou `/NONE` comme répertoire partagé.
L'exemple suivant montre comment monter Amazon EFS à`/efs`.
```
shared_dir = efs
```
[Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.](using-pcluster-update.md#update-policy-fail)
## `throughput_mode`
**(Facultatif)** Définit le mode de débit du système de fichiers. Cela correspond au [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode)paramètre indiqué dans le manuel *Amazon EFS API Reference*.
Les options valides sont les valeurs suivantes :
+ `bursting`
+ `provisioned`
La valeur par défaut est `bursting`.
```
throughput_mode = provisioned
```
[Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.](using-pcluster-update.md#update-policy-setting-supported)