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.
[cluster]
Section
Définit un modèle de cluster qui peut être utilisé pour créer un cluster. Un fichier de configuration peut contenir plusieurs [cluster]
sections.
Le même modèle de cluster peut être utilisé pour créer plusieurs clusters.
Le format est [cluster
. La [cluster]section nommée par le cluster_template paramètre de la [global]section est utilisée par défaut, mais elle peut être remplacée sur la pcluster ligne de commande.cluster-template-name
]
cluster-template-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 (_).
[cluster default]
Rubriques
- additional_cfn_template
- additional_iam_policies
- base_os
- cluster_resource_bucket
- cluster_type
- compute_instance_type
- compute_root_volume_size
- custom_ami
- cw_log_settings
- dashboard_settings
- dcv_settings
- desired_vcpus
- disable_cluster_dns
- disable_hyperthreading
- ebs_settings
- ec2_iam_role
- efs_settings
- enable_efa
- enable_efa_gdr
- enable_intel_hpc_platform
- encrypted_ephemeral
- ephemeral_dir
- extra_json
- fsx_settings
- iam_lambda_role
- initial_queue_size
- key_name
- maintain_initial_size
- master_instance_type
- master_root_volume_size
- max_queue_size
- max_vcpus
- min_vcpus
- placement
- placement_group
- post_install
- post_install_args
- pre_install
- pre_install_args
- proxy_server
- queue_settings
- raid_settings
- s3_read_resource
- s3_read_write_resource
- scaling_settings
- scheduler
- shared_dir
- spot_bid_percentage
- spot_price
- tags
- template_url
- vpc_settings
additional_cfn_template
(Facultatif) Définit un AWS CloudFormation modèle supplémentaire à lancer avec le cluster. Ce modèle supplémentaire est utilisé pour créer des ressources extérieures au cluster mais qui font partie du cycle de vie du cluster.
La valeur doit correspondre HTTP URL à un modèle public, avec tous les paramètres fournis.
Il n'existe aucune valeur par défaut.
additional_cfn_template = https://
<bucket-name>
.s3.amazonaws.com/my-cfn-template.yaml
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
additional_iam_policies
(Facultatif) Spécifie une liste de noms de ressources Amazon (ARNs) des IAM politiques pour AmazonEC2. Cette liste est attachée au rôle root utilisé dans le cluster, en plus des autorisations requises, AWS ParallelCluster séparées par des virgules. Le nom d'une IAM politique et son nom ARN sont différents. Les noms ne peuvent pas être utilisés comme argument pouradditional_iam_policies
.
Si votre intention est d'ajouter des politiques supplémentaires aux paramètres par défaut des nœuds de cluster, nous vous recommandons de transmettre les IAM politiques personnalisées supplémentaires avec le additional_iam_policies
paramètre au lieu de ec2_iam_roleles utiliser pour ajouter vos EC2 politiques spécifiques. Cela est dû au fait que additional_iam_policies
sont ajoutés aux autorisations par défaut AWS ParallelCluster requises. Un document existant ec2_iam_roledoit inclure toutes les autorisations requises. Cependant, étant donné que les autorisations requises changent souvent d'une version à l'autre au fur et à mesure que des fonctionnalités sont ajoutées, une version existante ec2_iam_rolepeut devenir obsolète.
Il n'existe aucune valeur par défaut.
additional_iam_policies = arn:aws:iam::123456789012:policy/
CustomEC2Policy
Note
Support pour additional_iam_policiesa été ajouté dans la AWS ParallelCluster version 2.5.0.
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
base_os
(Obligatoire)Spécifie le type de système d'exploitation utilisé dans le cluster.
Les options disponibles sont :
-
alinux2
-
centos7
-
ubuntu1804
-
ubuntu2004
Note
Pour les instances AWS basées sur Graviton, uniquement alinux2
ubuntu1804
, ou ubuntu2004
sont prises en charge.
Note
Support pour centos8
a été supprimé dans la AWS ParallelCluster version 2.11.4. Le support pour ubuntu2004
a été ajouté et le support pour alinux
et ubuntu1604
a été supprimé dans la AWS ParallelCluster version 2.11.0. Support pour centos8
a été ajouté et le support pour centos6
a été supprimé dans la AWS ParallelCluster version 2.10.0. Support pour alinux2
a été ajouté dans la AWS ParallelCluster
version 2.6.0. Support pour ubuntu1804
a été ajouté, et le support pour ubuntu1404
a été supprimé dans la AWS ParallelCluster version 2.5.0.
À l'exception des informations spécifiques Régions AWS mentionnées dans le tableau suivant qui ne sont pas prises en chargecentos7
. Toutes les autres régions AWS commerciales prennent en charge tous les systèmes d'exploitation suivants.
Cloison (Régions AWS) | alinux2 |
centos7 |
ubuntu1804 et ubuntu2004 |
---|---|---|---|
Commercial (tout cela Régions AWS n'est pas spécifiquement mentionné) | True | True | True |
AWS GovCloud (USA Est) (us-gov-east-1 ) |
True | False | True |
AWS GovCloud (US-Ouest) (us-gov-west-1 ) |
True | False | True |
Chine (Beijing) (cn-north-1 ) |
True | False | True |
Chine (Ningxia) (cn-northwest-1 ) |
True | False | True |
Note
Le base_os paramètre détermine également le nom d'utilisateur utilisé pour se connecter au cluster.
-
centos7
:centos
-
ubuntu1804
etubuntu2004
:ubuntu
-
alinux2
:ec2-user
Note
Avant AWS ParallelCluster la version 2.7.0, le base_os paramètre était facultatif et le paramètre par défaut étaitalinux
. À partir de AWS ParallelCluster
la version 2.7.0, le base_os paramètre est obligatoire.
Note
Si le paramètre scheduler est awsbatch
, seul alinux2
est pris en charge.
base_os = alinux2
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
cluster_resource_bucket
(Facultatif) Spécifie le nom du compartiment Amazon S3 utilisé pour héberger les ressources générées lors de la création du cluster. Le contrôle de version du bucket doit être activé. Pour plus d'informations, consultez la section Utilisation du versionnement dans le guide de l'utilisateur d'Amazon Simple Storage Service. Ce bucket peut être utilisé pour plusieurs clusters. Le compartiment doit se trouver dans la même région que le cluster.
Si ce paramètre n'est pas spécifié, un nouveau compartiment est créé lors de la création du cluster. Le nouveau compartiment porte le nom deparallelcluster-
. Dans ce nom, random_string
random_string
est une chaîne aléatoire de caractères alphanumériques. Toutes les ressources du cluster sont stockées dans ce compartiment dans un chemin associé au formulaire
. bucket_name
/resource_directory
resource_directory
a la forme
, où stack_name
-random_string
stack_name
est le nom de l'une des AWS CloudFormation piles utilisées par AWS ParallelCluster. La valeur de bucket_name
se trouve dans la ResourcesS3Bucket
valeur de la sortie de la parallelcluster-
pile. La valeur de clustername
resource_directory
se trouve dans la valeur de la ArtifactS3RootDirectory
sortie de la même pile.
La valeur par défaut est parallelcluster-
.random_string
cluster_resource_bucket = amzn-s3-demo-bucket
Note
Support pour cluster_resource_bucket a été ajouté dans la AWS ParallelCluster version 2.10.0.
cluster_type
(Facultatif) Définit le type de cluster à lancer. Si le queue_settings paramètre est défini, il doit être remplacé par les compute_type paramètres des [queue]sections.
Les options valides sont ondemand
et spot
.
La valeur par défaut est ondemand
.
Pour plus d'informations sur les instances Spot, consultez Utilisation de instances Spot.
Note
L'utilisation d'instances Spot nécessite que le rôle AWSServiceRoleForEC2Spot
lié au service existe dans votre compte. Pour créer ce rôle dans votre compte à l'aide de AWS CLI, exécutez la commande suivante :
aws iam create-service-linked-role --aws-service-name spot.amazonaws.com
Pour plus d'informations, consultez la section Rôle lié au service pour les demandes d'instance Spot dans le guide de EC2l'utilisateur Amazon.
cluster_type = ondemand
compute_instance_type
(Facultatif) Définit le type d'EC2instance Amazon utilisé pour les nœuds de calcul du cluster. L'architecture du type d'instance doit être identique à celle utilisée pour le master_instance_type paramètre. Si le queue_settings paramètre est défini, il doit être remplacé par les instance_type paramètres des [compute_resource]sections.
Si vous utilisez le awsbatch
planificateur, consultez la section Création d'environnements de calcul dans l' AWS Batch interface utilisateur pour obtenir la liste des types d'instances pris en charge.
Valeur par défaut t2.micro
, optimal
lorsque le planificateur est awsbatch
.
compute_instance_type = t2.micro
Note
Support pour les instances AWS basées sur Graviton (y compris les C6g
instances A1
et) a été ajouté dans la AWS ParallelCluster version 2.8.0.
compute_root_volume_size
(Facultatif) Spécifie la taille du volume ComputeFleet racine en gibioctets (GiB). Ils AMI doivent soutenirgrowroot
.
La valeur par défaut est 35
.
Note
Pour AWS ParallelCluster les versions entre 2.5.0 et 2.10.4, la valeur par défaut était 25. Avant AWS ParallelCluster la version 2.5.0, la valeur par défaut était 20.
compute_root_volume_size = 35
custom_ami
(Facultatif) Spécifie l'ID d'une personnalisation AMI à utiliser pour les nœuds de tête et de calcul au lieu de l'identifiant publié
Il n'existe aucune valeur par défaut.
custom_ami = ami-00d4efc81188687a0
Si la personnalisation AMI nécessite des autorisations supplémentaires pour son lancement, ces autorisations doivent être ajoutées aux politiques de l'utilisateur et du nœud principal.
Par exemple, si un instantané chiffré AMI est associé à une personnalisation, les politiques supplémentaires suivantes sont requises à la fois dans les politiques de l'utilisateur et du nœud principal :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:DescribeKey", "kms:ReEncrypt*", "kms:CreateGrant", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:
<AWS_REGION>
:<AWS_ACCOUNT_ID>
:key/<AWS_KMS_KEY_ID>
" ] } ] }
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
cw_log_settings
(Facultatif) Identifie la [cw_log]
section avec la configuration CloudWatch des journaux. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez les [cw_log]sectionsTableau de CloudWatch bord Amazon, etIntégration à Amazon CloudWatch Logs.
Par exemple, le paramètre suivant indique que la section qui démarre [cw_log custom-cw]
est utilisée pour la configuration CloudWatch des journaux.
cw_log_settings = custom-cw
Note
Support pour cw_log_settings a été ajouté dans la AWS ParallelCluster version 2.6.0.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
dashboard_settings
(Facultatif) Identifie la [dashboard]
section avec la configuration du CloudWatch tableau de bord. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [dashboard]section.
Par exemple, le paramètre suivant indique que la section qui commence [dashboard
custom-dashboard
est utilisée pour la configuration du CloudWatch tableau de bord.
dashboard_settings = custom-dashboard
Note
Support pour dashboard_settings a été ajouté dans la AWS ParallelCluster version 2.10.0.
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
dcv_settings
(Facultatif) Identifie la [dcv]
section avec la DCV configuration Amazon. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [dcv]section.
Par exemple, le paramètre suivant indique que la section qui commence [dcv custom-dcv]
est utilisée pour la DCV configuration Amazon.
dcv_settings = custom-dcv
Note
Sur les instances AWS basées sur Graviton, Amazon n'DCVest pris en charge que sur. alinux2
Note
Support pour dcv_settings a été ajouté dans la AWS ParallelCluster version 2.5.0.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
desired_vcpus
(Facultatif) Spécifie le nombre souhaité de vCPUs dans l'environnement informatique. Utilisé uniquement si le planificateur est awsbatch
.
La valeur par défaut est 4
.
desired_vcpus = 4
Politique de mise à jour : ce paramètre n'est pas analysé lors d'une mise à jour.
disable_cluster_dns
(Facultatif) Spécifie si les DNS entrées du cluster ne doivent pas être créées. Par défaut, AWS ParallelCluster crée une zone hébergée Route 53. Si disable_cluster_dns
ce paramètre est défini surtrue
, la zone hébergée n'est pas créée.
La valeur par défaut est false
.
disable_cluster_dns = true
Avertissement
Un système de résolution de noms est nécessaire au bon fonctionnement du cluster. Si disable_cluster_dns
ce paramètre est défini surtrue
, un système de résolution de noms supplémentaire doit également être fourni.
Important
disable_cluster_dns= n'true
est pris en charge que si le queue_settings paramètre est spécifié.
Note
Support pour disable_cluster_dns a été ajouté dans la AWS ParallelCluster version 2.9.1.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
disable_hyperthreading
(Facultatif) Désactive l'hyperthreading sur les nœuds de tête et de calcul. Tous les types d'instance ne peuvent pas désactiver l'hyper-threading. Pour obtenir la liste des types d'instances qui prennent en charge la désactivation de l'hyperthreading, consultez la section CPUcœurs et threads de chaque CPU cœur pour chaque type d'instance dans le guide de l'utilisateur Amazon EC2. Si le queue_settings paramètre est défini, soit ce paramètre peut être défini, soit les disable_hyperthreading paramètres des [queue]sections peuvent être définis.
La valeur par défaut est false
.
disable_hyperthreading = true
Note
disable_hyperthreadingn'affecte le nœud principal que lorsquescheduler = awsbatch
.
Note
Support pour disable_hyperthreading a été ajouté dans la AWS ParallelCluster version 2.5.0.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
ebs_settings
(Facultatif) Identifie les [ebs]
sections contenant les EBS volumes Amazon montés sur le nœud principal. Lorsque vous utilisez plusieurs EBS volumes Amazon, entrez ces paramètres dans une liste, chacun étant séparé par une virgule. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Jusqu'à cinq (5) EBS volumes Amazon supplémentaires sont pris en charge.
Pour plus d'informations, consultez la [ebs]section.
Par exemple, le paramètre suivant indique que les sections démarrent [ebs custom1]
et [ebs custom2]
sont utilisées pour les EBS volumes Amazon.
ebs_settings = custom1, custom2
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
ec2_iam_role
(Facultatif) Définit le nom d'un IAM rôle existant pour Amazon EC2 qui est attaché à toutes les instances du cluster. IAMLe nom d'un rôle et son Amazon Resource Name (ARN) sont différents. ARNsne peut pas être utilisé comme argument pourec2_iam_role
.
Si cette option est spécifiée, le paramètre additional_iam_policies est ignoré. Si votre intention est d'ajouter des politiques supplémentaires aux paramètres par défaut des nœuds de cluster, nous vous recommandons de transmettre les IAM politiques personnalisées supplémentaires avec le additional_iam_policiesparamètre au lieu de ec2_iam_role
les utiliser.
Si cette option n'est pas spécifiée, le AWS ParallelCluster IAM rôle par défaut d'Amazon EC2 est utilisé. Pour de plus amples informations, veuillez consulter AWS Identity and Access Management rôles dans AWS ParallelCluster.
Il n'existe aucune valeur par défaut.
ec2_iam_role = ParallelClusterInstanceRole
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
efs_settings
(Facultatif) Spécifie les paramètres liés au système de EFS fichiers Amazon. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [efs]section.
Par exemple, le paramètre suivant indique que la section qui commence [efs customfs]
est utilisée pour la configuration du système de EFS fichiers Amazon.
efs_settings = customfs
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
enable_efa
(Facultatif) Le cas échéant, indique qu'Elastic Fabric Adapter (EFA) est activé pour les nœuds de calcul. Pour consulter la liste des EC2 instances compatiblesEFA, consultez la section Types d'instances pris en charge dans le Guide de EC2 l'utilisateur Amazon pour les instances Linux. Pour de plus amples informations, veuillez consulter Elastic Fabric Adapter. Si le queue_settings paramètre est défini, soit ce paramètre peut être défini, soit les enable_efa paramètres de la [queue]section peuvent être définis. Un groupe de placement de cluster doit être utilisé pour minimiser les latences entre les instances. Pour plus d’informations, consultez placement et placement_group.
enable_efa = compute
Note
Support pour les instances Graviton2 basées EFA sur ARM a été ajouté dans AWS ParallelCluster la version 2.10.1.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
enable_efa_gdr
(Facultatif) À partir de AWS ParallelCluster la version 2.11.3, ce paramètre n'a aucun effet. La prise en charge par Elastic Fabric Adapter GPUDirect RDMA (EFA) pour (accès direct à distance à la mémoire) est toujours activée si elle est prise en charge à la fois par le type d'instance et par le système d'exploitation.
Note
AWS ParallelCluster versions 2.10.0 à 2.11.2 : Sicompute
, indique que le support d'Elastic Fabric Adapter (EFA) pour GPUDirect RDMA (accès direct à la mémoire à distance) est activé pour les nœuds de calcul. Pour définir ce paramètre sur, il compute
doit être défini surcompute
. enable_efa EFAla prise en charge de GPUDirect RDMA est prise en charge par des types d'instances spécifiques (p4d.24xlarge
) sur des systèmes d'exploitation spécifiques (base_osis alinux2
centos7
ubuntu1804
,, ouubuntu2004
). Si le queue_settings paramètre est défini, soit ce paramètre peut être défini, soit les enable_efa_gdr paramètres des [queue]sections peuvent être définis. Un groupe de placement de cluster doit être utilisé pour minimiser les latences entre les instances. Pour plus d’informations, consultez placement et placement_group.
enable_efa_gdr = compute
Note
Support pour enable_efa_gdr
a été ajouté dans la AWS ParallelCluster version 2.10.0.
enable_intel_hpc_platform
(Facultatif) Le cas échéant, indique que le contrat de licence utilisateur final = centos7
).
La valeur par défaut est false
.
enable_intel_hpc_platform = true
Note
Le enable_intel_hpc_platform paramètre n'est pas compatible avec les instances AWS basées sur Graviton.
Note
Support pour enable_intel_hpc_platform a été ajouté dans la AWS ParallelCluster version 2.5.0.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
encrypted_ephemeral
(Facultatif) Chiffre les volumes de stockage de l'instance éphémère avec des clés en mémoire non récupérables, à l'aide LUKS de (Linux Unified Key Setup).
Pour de plus amples informations, veuillez consulter https://gitlab.com/cryptsetup/cryptsetup/blob/master/README.md
La valeur par défaut est false
.
encrypted_ephemeral = true
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
ephemeral_dir
(Facultatif) Définit le chemin où les volumes de stockage d'instance sont montés s'ils sont utilisés.
La valeur par défaut est /scratch
.
ephemeral_dir = /scratch
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
extra_json
(Facultatif) Définit le supplément JSON qui est fusionné dans Chef dna.json
. Pour plus d'informations, consultez Création d'une AMI AWS ParallelCluster personnalisée.
La valeur par défaut est {}
.
extra_json = {}
Note
À partir de AWS ParallelCluster la version 2.6.1, la plupart des recettes d'installation sont ignorées par défaut lors du lancement des nœuds afin d'améliorer les temps de démarrage. Pour exécuter toutes les recettes d'installation afin d'améliorer la rétrocompatibilité au détriment des temps de démarrage, ajoutez "skip_install_recipes" : "no"
la cluster
clé dans le extra_json paramètre. Par exemple :
extra_json = { "cluster" : { "skip_install_recipes" : "no" } }
fsx_settings
(Facultatif) Spécifie la section qui définit la configuration FSx pour Lustre. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [fsx]section.
Par exemple, le paramètre suivant indique que la section qui commence [fsx fs]
est utilisée pour la configuration FSx for Lustre.
fsx_settings = fs
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
iam_lambda_role
(Facultatif) Définit le nom d'un rôle AWS Lambda d'exécution existant. Ce rôle est associé à toutes les fonctions Lambda du cluster. Pour plus d'informations, veuillez consulter Rôle d'exécution AWS Lambda dans le Guide du développeur AWS Lambda .
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
IAMLe nom d'un rôle et son Amazon Resource Name (ARN) sont différents. ARNsne peut pas être utilisé comme argument pouriam_lambda_role
. Si les deux ec2_iam_role iam_lambda_role
sont définis et que le « scheduler est sge
» ou « ou »torque
, aucun rôle ne sera créé. slurm
Si tel scheduler est le casawsbatch
, des rôles seront créés pendantpcluster start. Par exemple, les politiques, voir ParallelClusterLambdaPolicyen utilisant SGE, Slurm, ou Torque etParallelClusterLambdaPolicy utilisant awsbatch.
Il n'existe aucune valeur par défaut.
iam_lambda_role = ParallelClusterLambdaRole
Note
Support pour iam_lambda_role
a été ajouté dans la AWS ParallelCluster version 2.10.1.
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
initial_queue_size
(Facultatif) Définit le nombre initial d'EC2instances Amazon à lancer en tant que nœuds de calcul dans le cluster. Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par les initial_count paramètres des [compute_resource]sections.
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
Ce paramètre s'applique uniquement aux planificateurs traditionnels (SGE, Slurm, et Torque). Si le maintain_initial_size réglage est le initial_queue_size castrue
, il doit être d'au moins un (1).
Si le planificateur est awsbatch
, utilisez min_vcpus à la place.
La valeur par défaut est 2
.
initial_queue_size = 2
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
key_name
(Facultatif) Nomme une paire de EC2 clés Amazon existante permettant SSH d'accéder aux instances.
key_name = mykey
Note
Avant AWS ParallelCluster la version 2.11.0, key_name
c'était un paramètre obligatoire.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
maintain_initial_size
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
(Facultatif) Conserve la taille initiale du groupe Auto Scaling pour les planificateurs traditionnels (SGE, Slurm, et Torque).
Si le planificateur est awsbatch
, utilisez desired_vcpus à la place.
Ce paramètre est un indicateur booléen. S'il est défini surtrue
, le groupe Auto Scaling ne compte jamais moins de membres que la valeur deinitial_queue_size, et la valeur de initial_queue_size doit être supérieure ou égale à un (1). Le cluster peut encore être mis à l'échelle jusqu'à la valeur de max_queue_size. Dans cluster_type = spot
ce cas, les instances du groupe Auto Scaling peuvent être interrompues et leur taille peut diminuerinitial_queue_size.
S'il est défini surfalse
, le groupe Auto Scaling peut être réduit à zéro (0) membre afin d'éviter que les ressources ne restent inutilisées lorsqu'elles ne sont pas nécessaires.
Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par les min_count paramètres initial_count et dans les [compute_resource]sections.
La valeur par défaut est false
.
maintain_initial_size = false
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
master_instance_type
(Facultatif) Définit le type d'EC2instance Amazon utilisé pour le nœud principal. L'architecture du type d'instance doit être identique à celle utilisée pour le compute_instance_type paramètre.
Dans Régions AWS le cas d'un niveau gratuit, le type d'instance par défaut est le niveau gratuit (t2.micro
out3.micro
). Si vous Régions AWS n'avez pas de niveau gratuit, la valeur par défaut est. t3.micro
Pour plus d'informations sur le niveau AWS gratuit, consultez le niveau AWS gratuit FAQs
master_instance_type = t2.micro
Note
Avant AWS ParallelCluster la version 2.10.1, la valeur par défaut était « t2.micro
in all ». Régions AWS Dans AWS ParallelCluster la version 2.10.0, le nœud p4d.24xlarge
principal n'était pas pris en charge. Support pour les instances AWS basées sur Graviton (telles que A1
etC6g
) a été ajouté dans la AWS ParallelCluster version 2.8.0.
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
master_root_volume_size
(Facultatif) Spécifie la taille du volume racine du nœud principal en gibioctets (GiB). Ils AMI doivent soutenirgrowroot
.
La valeur par défaut est 35
.
Note
Pour AWS ParallelCluster les versions entre 2.5.0 et 2.10.4, la valeur par défaut était 25. Avant AWS ParallelCluster la version 2.5.0, la valeur par défaut était 20.
master_root_volume_size = 35
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
max_queue_size
(Facultatif) Définit le nombre maximum d'EC2instances Amazon pouvant être lancées dans le cluster. Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par les max_count paramètres des [compute_resource]sections.
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
Ce paramètre s'applique uniquement aux planificateurs traditionnels (SGE, Slurm, et Torque).
Si le planificateur est awsbatch
, utilisez max_vcpus à la place.
La valeur par défaut est 10
.
max_queue_size = 10
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour, mais le parc informatique doit être arrêté si la valeur est réduite. Dans le cas contraire, les nœuds existants risquent d'être résiliés.
max_vcpus
(Facultatif) Spécifie le nombre maximum de vCPUs dans l'environnement de calcul. Utilisé uniquement si le planificateur est awsbatch
.
La valeur par défaut est 20
.
max_vcpus = 20
Politique de mise à jour : ce paramètre ne peut pas être réduit lors d'une mise à jour.
min_vcpus
(Facultatif) Conserve la taille initiale du groupe Auto Scaling pour le awsbatch
planificateur.
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
Si le planificateur est SGE, Slurm, ou Torque, utilisez maintain_initial_size plutôt.
L'environnement de calcul ne compte jamais moins de membres que la valeur de min_vcpus.
La valeur par défaut est 0
.
min_vcpus = 0
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
placement
(Facultatif) Définit la logique du groupe de placement du cluster, permettant à l'ensemble du cluster ou uniquement aux instances de calcul d'utiliser le groupe de placement du cluster.
Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par des placement_group paramètres pour chacune des [queue]sections. Si le même groupe de placement est utilisé pour différents types d'instances, il est plus probable que la demande échoue en raison d'une erreur de capacité insuffisante. Pour plus d'informations, consultez la section Capacité d'instance insuffisante dans le guide de EC2 l'utilisateur Amazon. Plusieurs files d'attente ne peuvent partager un groupe de placement que s'il a été créé à l'avance et configuré dans les placement_group paramètres de chaque file d'attente. Si chaque [queue]section définit un placement_group paramètre, le nœud principal ne peut pas figurer dans le groupe de placement d'une file d'attente.
Les options valides sont cluster
ou compute
.
Ce paramètre n'est pas utilisé lorsque le planificateur l'est. awsbatch
La valeur par défaut est compute
.
placement = compute
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
placement_group
(Facultatif) Définit le groupe de placement du cluster. Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par les placement_group paramètres des [queue]sections.
Les options valides sont les valeurs suivantes :
-
DYNAMIC
-
Nom d'un groupe de placement de EC2 clusters Amazon existant
Lorsque DYNAMIC
est défini, un groupe de placement unique est créé et supprimé dans la pile du cluster.
Ce paramètre n'est pas utilisé lorsque le planificateur l'est. awsbatch
Pour plus d'informations sur les groupes de placement, consultez la section Groupes de placement dans le guide de EC2 l'utilisateur Amazon. Si le même groupe de placement est utilisé pour différents types d'instances, il est plus probable que la demande échoue en raison d'une erreur de capacité insuffisante. Pour plus d'informations, consultez la section Capacité d'instance insuffisante dans le guide de EC2 l'utilisateur Amazon.
Il n'existe aucune valeur par défaut.
Tous les types d'instance ne prennent pas en charge les groupes de placement de cluster. Par exemple, le type d'instance par défaut t3.micro
ne prend pas en charge les groupes de placement de clusters. Pour plus d'informations sur la liste des types d'instances qui prennent en charge les groupes de placement de clusters, consultez la section Règles et limites des groupes de placement de clusters dans le guide de EC2 l'utilisateur Amazon. Consultez Problèmes liés aux groupes de placement et au lancement d'instances pour obtenir des conseils pour l'utilisation des groupes de placement.
placement_group = DYNAMIC
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
post_install
(Facultatif) Spécifie le script URL de post-installation qui est exécuté une fois que toutes les actions d'amorçage du nœud sont terminées. Pour de plus amples informations, veuillez consulter Actions d'amorçage personnalisées.
Lorsqu'il est utilisé awsbatch
comme planificateur, le script de post-installation est exécuté uniquement sur le nœud principal.
Le format du paramètre peut être http://
ou hostname/path/to/script.sh
s3://
.bucketname/path/to/script.sh
Il n'existe aucune valeur par défaut.
post_install = s3://
<bucket-name>
/my-post-install-script.sh
post_install_args
(Facultatif) Spécifie une liste d'arguments entre guillemets à transmettre au script de post-installation.
Il n'existe aucune valeur par défaut.
post_install_args = "
argument-1
argument-2
"
pre_install
(Facultatif) Spécifie le script URL de préinstallation qui est exécuté avant le lancement de toute action d'amorçage du déploiement d'un nœud. Pour de plus amples informations, veuillez consulter Actions d'amorçage personnalisées.
Lorsqu'il est utilisé awsbatch
comme planificateur, le script de préinstallation est exécuté uniquement sur le nœud principal.
Le format du paramètre peut être http://
ou hostname/path/to/script.sh
s3://
.bucketname/path/to/script.sh
Il n'existe aucune valeur par défaut.
pre_install = s3://
<bucket-name>
/my-pre-install-script.sh
pre_install_args
(Facultatif) Spécifie une liste d'arguments entre guillemets à transmettre au script de préinstallation.
Il n'existe aucune valeur par défaut.
pre_install_args = "
argument-3
argument-4
"
proxy_server
(Facultatif) Définit généralement un serveur HTTPS proxy HTTP ouhttp://
.x.x.x.x:8080
Il n'existe aucune valeur par défaut.
proxy_server = http://
10.11.12.13:8080
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
queue_settings
(Facultatif) Spécifie que le cluster utilise des files d'attente au lieu d'un parc informatique homogène, et indique quelles [queue]sections sont utilisées. La première [queue]section répertoriée est la file d'attente du planificateur par défaut. Les noms de queue
section doivent commencer par une lettre minuscule, ne pas contenir plus de 30 caractères et ne contenir que des lettres minuscules, des chiffres et des tirets (-).
Important
queue_settingsn'est pris en charge que lorsqu'scheduleril est défini surslurm
. Les spot_price paramètres cluster_typecompute_instance_type,initial_queue_size,maintain_initial_size,max_queue_size, placementplacement_group, et ne doivent pas être spécifiés. Les enable_efa paramètres disable_hyperthreading et peuvent être spécifiés dans la [cluster]section ou dans les [queue]sections, mais pas dans les deux.
Jusqu'à cinq (5) [queue]sections sont prises en charge.
Pour plus d'informations, consultez la [queue]section.
Par exemple, le paramètre suivant indique que les sections qui démarrent [queue q1]
et [queue q2]
sont utilisées.
queue_settings = q1, q2
Note
Support pour queue_settings a été ajouté dans la AWS ParallelCluster version 2.9.0.
raid_settings
(Facultatif) Identifie la [raid]
section contenant la RAID configuration EBS du volume Amazon. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [raid]section.
Par exemple, le paramètre suivant indique que la section qui commence [raid rs]
doit être utilisée pour la configuration Auto Scaling.
raid_settings = rs
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
s3_read_resource
(Facultatif) Spécifie une ressource Amazon S3 à laquelle les AWS ParallelCluster nœuds bénéficient d'un accès en lecture seule.
Par exemple, arn:aws:s3:::
fournit un accès en lecture seule au my_corporate_bucket
*my_corporate_bucket
et aux objets qu'il contient.
Consultez la section Travailler avec Amazon S3 pour plus de détails sur le format.
Il n'existe aucune valeur par défaut.
s3_read_resource = arn:aws:s3:::
my_corporate_bucket
*
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
s3_read_write_resource
(Facultatif) Spécifie une ressource Amazon S3 à laquelle les AWS ParallelCluster nœuds ont un accès en lecture/écriture.
Par exemple, arn:aws:s3:::
fournit un accès en lecture/écriture à tous les objets du my_corporate_bucket
/Development/*Development
dossier du my_corporate_bucket
seau.
Consultez la section Travailler avec Amazon S3 pour plus de détails sur le format.
Il n'existe aucune valeur par défaut.
s3_read_write_resource = arn:aws:s3:::
my_corporate_bucket
/*
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
scaling_settings
Identifie la [scaling]
section avec la configuration Auto Scaling. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [scaling]section.
Par exemple, le paramètre suivant indique que la section qui commence [scaling custom]
est utilisée pour la configuration Auto Scaling.
scaling_settings = custom
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
scheduler
(Obligatoire)Définit le planificateur du cluster.
Les options valides sont les valeurs suivantes :
awsbatch
-
AWS Batch
Pour plus d'informations sur le
awsbatch
planificateur, consultez les sections Configuration réseau et. AWS Batch (awsbatch) sge
-
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
Son of Grid Engine (SGE)
slurm
-
Slurm Workload Manager (Slurm)
torque
-
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
Torque Resource Manager (Torque)
Note
Avant AWS ParallelCluster la version 2.7.0, le scheduler
paramètre était facultatif et le paramètre par défaut étaitsge
. À partir de AWS ParallelCluster la version 2.7.0, le scheduler
paramètre est obligatoire.
scheduler = slurm
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
shared_dir
(Facultatif) Définit le chemin où le EBS volume Amazon partagé est monté.
N'utilisez pas cette option avec plusieurs EBS volumes Amazon. Indiquez plutôt des shared_dir valeurs sous chaque [ebs]section.
Consultez la [ebs]section pour en savoir plus sur l'utilisation de plusieurs EBS volumes Amazon.
La valeur par défaut est /shared
.
L'exemple suivant montre un EBS volume Amazon partagé monté sur/myshared
.
shared_dir = myshared
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
spot_bid_percentage
(Facultatif) Définit le pourcentage à la demande utilisé pour calculer le ComputeFleet prix spot maximum pour awsbatch
le planificateur.
S'il n'est pas spécifié, le prix du marché spot actuel est sélectionné, plafonné au prix à la demande.
spot_bid_percentage = 85
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
spot_price
Note
À partir de la version 2.11.5, AWS ParallelCluster ne prend pas en charge l'utilisation de SGE or Torque planificateurs.
(Facultatif) Définit le prix spot maximum pour ComputeFleet les planificateurs traditionnels (SGE, Slurm, et Torque). Utilisé uniquement lorsque le cluster_type paramètre est défini surspot
. Si vous ne spécifiez aucune valeur, le prix au comptant vous est facturé, plafonné au prix à la demande. Si le queue_settings paramètre est défini, il doit être supprimé et remplacé par les spot_price paramètres des [compute_resource]sections.
Si le planificateur est awsbatch
, utilisez spot_bid_percentage à la place.
Pour obtenir de l'aide pour trouver une instance Spot qui répond à vos besoins, consultez le conseiller en matière d'instances Spot
spot_price = 1.50
Note
Dans AWS ParallelCluster la version 2.5.0, si l'cluster_type = spot
erreur spot_price n'est pas spécifiée, l'instance démarre en cas d' ComputeFleet échec. Cela a été corrigé dans la AWS ParallelCluster version 2.5.1.
Politique de mise à jour : ce paramètre peut être modifié lors d'une mise à jour.
tags
(Facultatif) Définit les balises à utiliser par AWS CloudFormation.
Si les balises de la ligne de commande sont spécifiées via --tags, elles sont fusionnées aux balises de configuration.
Les balises de ligne de commande remplacent les balises de configuration qui ont la même clé.
Les balises sont JSON formatées. N'utilisez pas de guillemets en dehors des bretelles.
Pour plus d'informations, consultez la section Type de balises de AWS CloudFormation ressource dans le Guide de AWS CloudFormation l'utilisateur.
tags = {"key" : "value", "key2" : "value2"}
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.
Note
La politique de mise à jour ne permettait pas de modifier les tags
paramètres de la AWS ParallelCluster
version 2.8.0 à la version 2.9.1.
Pour les versions 2.10.0 à 2.11.7, la politique de mise à jour répertoriée qui prenait en charge la modification du tags
paramètre n'est pas exacte. La mise à jour du cluster lors de la modification de ce paramètre n'est pas prise en charge.
template_url
(Facultatif) Définit le chemin d'accès au AWS CloudFormation modèle utilisé pour créer le cluster.
Met à jour l'utilisation du modèle initialement utilisé pour créer la pile.
La valeur par défaut est https://
.aws_region_name
-aws-parallelcluster.s3.amazonaws.com/templates/aws-parallelcluster-version
.cfn.json
Avertissement
Il s'agit d'un paramètre avancé. Toute modification de ce paramètre est effectuée à vos risques et périls.
template_url = https://us-east-1-aws-parallelcluster.s3.amazonaws.com/templates/aws-parallelcluster-2.11.9.cfn.json
Politique de mise à jour : ce paramètre n'est pas analysé lors d'une mise à jour.
vpc_settings
(Obligatoire) Identifie la [vpc]
section contenant la VPC configuration Amazon dans laquelle le cluster est déployé. Le nom de section doit commencer par une lettre, ne pas contenir plus de 30 caractères et uniquement contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_).
Pour plus d'informations, consultez la [vpc]section.
Par exemple, le paramètre suivant indique que la section qui commence [vpc public]
est utilisée pour la VPC configuration Amazon.
vpc_settings = public
Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.