[efs] Section - AWS ParallelCluster

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 de l'Amazon EFS qui est monté sur la tête et les nœuds de calcul. Pour plus d'informations, consultez CreateFileSystemla référence de l'API Amazon EFS.

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écifiezefs_fs_id.

Si vous ne le spécifiez pasefs_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 plus d'informations, veuillez consulter Bonnes pratiques : déplacer un cluster vers un nouveau AWS ParallelCluster version mineure ou correctif.

Le format est[efs efs-name]. efs-name doit commencer par une lettre, ne pas contenir plus de 30 caractères et ne contenir que des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).

[efs customfs] shared_dir = efs encrypted = false performance_mode = generalPurpose

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 deshared_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 dont une cible de montage existe déjà dans la zone de disponibilité de la pile et dont le trafic NFS entrant et sortant est autorisé. 0.0.0.0/0

La vérification d'intégrité pour valider 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 pour laquelle le trafic NFS entrant et sortant est autorisé0.0.0.0/0, cela expose le système de fichiers à des demandes de montage NFS provenant de n'importe quel endroit de la zone de disponibilité de la cible de montage. AWSne recommande pas de créer une cible de montage dans la zone de disponibilité de la pile. Laissez-nous plutôt AWS gérer cette étape. Si vous souhaitez avoir une cible de montage dans la zone de disponibilité de la pile, envisagez d'utiliser un groupe de sécurité personnalisé en fournissant une vpc_security_group_id option dans la [vpc]section. 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.

efs_kms_key_id

(Facultatif) Identifie la AWS Key Management Service (AWS KMS) clé gérée par le client à utiliser pour protéger le système de fichiers crypté. Si ce paramètre est défini, le paramètre encrypted doit être défini sur true. Cela correspond au KmsKeyIdparamètre de la référence d'API Amazon EFS.

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.

encrypted

(Facultatif) Indique si le système de fichiers est crypté. Cela correspond au paramètre 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.

performance_mode

(Facultatif) Définit le mode de performance du système de fichiers. Cela correspond au PerformanceModeparamètre de la référence d'API Amazon EFS.

Les options valides sont les valeurs suivantes :

  • generalPurpose

  • maxIO

Les deux valeurs font la distinction entre 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.

provisioned_throughput

(Facultatif) Définit le débit provisionné du système de fichiers, mesuré en MiB/s. Cela correspond au ProvisionedThroughputInMibpsparamètre de la référence d'API Amazon EFS.

Si vous utilisez ce paramètre, vous devez définir throughput_mode sur provisioned.

Le quota de débit est de 1024 MiB/s. Pour demander une augmentation de quota, contactez AWS 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.

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 est utilisée uniquement si elle shared_dir est spécifiée.

N'utilisez pas NONE or /NONE comme répertoire partagé.

L'exemple suivant montre comment monter Amazon EFS sur. /efs

shared_dir = efs

Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.

throughput_mode

(Facultatif) Définit le mode de débit du système de fichiers. Cela correspond au ThroughputModeparamètre de la référence d'API Amazon EFS.

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.