View a markdown version of this page

Configurer les plugins de filtre Slurm CLI sur un AWS Cluster PCS - AWS PIÈCES
Conditions préalablesActiver les plugins de filtre CLI sur un nouveau clusterDéployer des scripts du plug-in CLI FilterActiver ou désactiver les plugins de filtre CLI sur les clusters existantsRésultats attendusRésolution des problèmes

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.

Configurer les plugins de filtre Slurm CLI sur un AWS Cluster PCS

Configurez les plugins de filtre CLI lorsque vous créez un nouveau cluster AWS PCS. Vous pouvez activer ou désactiver les plug-ins de filtre CLI sur les clusters existants à l'aide de l'API de mise à jour ou de la console sans recréer le cluster.

Conditions préalables

Avant de configurer les plug-ins de filtre CLI, effectuez les tâches suivantes :

  • Vérifiez que vous utilisez la version 24.11 ou ultérieure de Slurm. Pour le 24.11 et le 25.05, voir. Exigences

  • Écrivez et testez un script Lua qui implémente l'API CLI Filter Plugin

  • Choisissez une méthode pour déployer votre script sur toutes les instances de cluster (AMI, S3 ou système de fichiers)

Activer les plugins de filtre CLI sur un nouveau cluster

AWS PCS console

  1. Ouvrez la console AWS PCS à l'adresse https://console.aws.amazon.com/pcs/.

  2. Dans le panneau de navigation, choisissez Clusters.

  3. Choisissez Créer un cluster.

  4. Sous Paramètres du planificateur, développez Paramètres supplémentaires du planificateur.

  5. Ajoutez un nouveau paramètre personnalisé Slurm avec le nom du paramètre défini sur CliFilterPlugins et la valeur du paramètre définie sur. cli_filter/lua

  6. Terminez la configuration de cluster restante et choisissez Créer un cluster.

AWS PCS API

Fournissez la slurmCustomSettings configuration dans votre appel à l'action d'CreateClusterAPI. Réglez les parameterName paramètres à CliFilterPlugins et parameterValue àcli_filter/lua. Pour plus d'informations, consultez CreateCluster la référence de l'API AWS PCS.

L'exemple suivant utilise le AWS CLI pour appeler l'action d'CreateClusterAPI. Le paramètre personnalisé CliFilterPlugins=cli_filter/lua active les plugins de filtre CLI.

aws pcs create-cluster --cluster-name cluster-name \
--scheduler type=SLURM,version=25.11 \
--size SMALL \
--networking subnetIds=cluster-subnet-id,securityGroupIds=cluster-security-group-id \
--slurm-configuration \
'slurmCustomSettings=[{parameterName=CliFilterPlugins,parameterValue="cli_filter/lua"}]'

Déployer des scripts du plug-in CLI Filter

Pour déployer des scripts du plug-in CLI Filter sur votre cluster

  1. Assurez-vous que Slurm est installé sur toutes les AMI utilisées dans les groupes de nœuds de calcul via le programme d'installation de AWS PCS Slurm.

    Note

    Si vous utilisez l'exemple d'AMI AWS PCS pour tous les groupes de nœuds de calcul, ignorez cette étape. Slurm est déjà installé.

  2. Déployez votre script Lua /etc/aws/pcs/scheduler/slurm-version/cli_filter.lua sur toutes les instances du cluster.

    Par exemple, pour la version 25.11 de Slurm :

    /etc/aws/pcs/scheduler/slurm-25.11/cli_filter.lua
    Note

    À partir de la version 25.11 de Slurm, vous pouvez personnaliser le chemin cli_filter_lua_path dans les paramètres personnalisés de CliFilterParameters Slurm. Ce paramètre a pour valeur par défaut /etc/aws/pcs/scheduler/slurm/cli_filter.lua. L'agent AWS PCS relie ce chemin à l'emplacement versionné à partir de la version v1.4.1-1.

  3. Lancez tous les nœuds de connexion et de calcul à l'aide des AMI que vous avez préparées.

  4. Soumission de tâches de test pour vérifier que le plug-in CLI Filter s'exécute correctement.

Activer ou désactiver les plugins de filtre CLI sur les clusters existants

Vous pouvez activer ou désactiver les plug-ins de filtre CLI sur les clusters existants sans reconstruire votre infrastructure. Pour de plus amples informations, veuillez consulter Mettre à jour un cluster dans AWS PIÈCES.

AWS PCS console

  1. Ouvrez la console AWS PCS à l'adresse https://console.aws.amazon.com/pcs/.

  2. Dans le panneau de navigation, choisissez Clusters.

  3. Sélectionnez le cluster à mettre à jour.

  4. Choisissez Modifier l'action.

  5. Sur la page Modifier le cluster, sous Paramètres supplémentaires du planificateur :

    • Pour activer les plugins de filtre CLI : ajoutez un nouveau paramètre personnalisé Slurm avec le nom du paramètre défini sur CliFilterPlugins et la valeur du paramètre définie sur. cli_filter/lua

    • Pour désactiver les plugins de filtre CLI : supprimez le CliFilterPlugins paramètre existant.

  6. Choisissez Mettre à jour le cluster pour soumettre les modifications.

  7. Surveillez l'état du cluster, qui s'affiche comme « En cours de mise à jour » pendant le processus et « Actif » une fois la mise à jour terminée.

AWS PCS API

Utilisez l'action d'UpdateClusterAPI pour activer ou désactiver les plugins de filtre CLI. Pour plus d'informations, consultez UpdateCluster la référence de l'API AWS PCS.

Pour activer les plugins de filtre CLI sur un cluster existant :

aws pcs update-cluster --cluster-identifier my-cluster \
--slurm-configuration \
'slurmCustomSettings=[{parameterName=CliFilterPlugins,parameterValue="cli_filter/lua"}]'

Pour désactiver les plugins de filtre CLI sur un cluster existant :

aws pcs update-cluster --cluster-identifier my-cluster \
--slurm-configuration \
'slurmCustomSettings=[]'

Résultats attendus

Une fois la configuration terminée :

  • Votre cluster est créé avec le plug-in CLI Filter activé

  • Les soumissions de tâches déclenchent votre logique de validation personnalisée avant d'atteindre le contrôleur Slurm

  • Non-compliant les tâches sont rejetées avec vos messages d'erreur personnalisés

  • Les tâches conformes se déroulent normalement via le planificateur Slurm

Résolution des problèmes

Le script du plug-in CLI Filter est manquant sur un nœud

Symptômes : la soumission des tâches échoue immédiatement en raison d'une erreur de chargement du plugin.

Cause probable : le script n'est pas déployé sur toutes les instances ou le chemin ou le nom du fichier sont incorrects.

Solution : Vérifiez que le script existe au bon chemin sur tous les nœuds de connexion et de calcul avec un nom de fichier cli_filter.lua exact.

Configuration du plug-in de filtre CLI non valide

Symptômes : la création du cluster échoue en raison d'une erreur de validation.

Cause probable : CliFilterPlugins le paramètre n'est pas configuré pour le cli_filter/lua format.

Résolution : utilisez la valeur exacte du paramètre cli_filter/lua dansslurmCustomSettings.