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. # AWS Batch (`awsbatch`) Pour plus d'informations sur AWS Batch, voir [AWS Batch](https://aws.amazon.com/batch/). Pour obtenir de la documentation, consultez le [guide de AWS Batch l'utilisateur](https://docs.aws.amazon.com/batch/latest/userguide/). **AWS ParallelCluster Commandes CLI pour AWS Batch** Lorsque vous utilisez le `awsbatch` planificateur, les commandes AWS ParallelCluster CLI pour AWS Batch sont automatiquement installées dans le nœud AWS ParallelCluster principal. La CLI utilise des opérations d' AWS Batch API et autorise les opérations suivantes : + Envoyer et gérer les tâches. + Surveiller les tâches, les files d'attente et les hôtes. + Mettre en miroir les commandes traditionnelles du planificateur. **Important** AWS ParallelCluster ne prend pas en charge les tâches GPU pour AWS Batch. Pour plus d'informations, consultez la section [Tâches GPU](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html). **Topics** + [ # `awsbsub` ](awsbatchcli.awsbsub.md) + [ # `awsbstat` ](awsbatchcli.awsbstat.md) + [ # `awsbout` ](awsbatchcli_awsbout.md) + [ # `awsbkill` ](awsbatchcli_awsbkill.md) + [ # `awsbqueues` ](awsbatchcli_awsbqueues.md) + [ # `awsbhosts` ](awsbatchcli_awsbhosts.md) # `awsbsub` Soumet les tâches à la file d'attente des tâches du cluster. ``` awsbsub [-h] [-jn JOB_NAME] [-c CLUSTER] [-cf] [-w WORKING_DIR] [-pw PARENT_WORKING_DIR] [-if INPUT_FILE] [-p VCPUS] [-m MEMORY] [-e ENV] [-eb ENV_DENYLIST] [-r RETRY_ATTEMPTS] [-t TIMEOUT] [-n NODES] [-a ARRAY_SIZE] [-d DEPENDS_ON] [command] [arguments [arguments ...]] ``` **Important** AWS ParallelCluster ne prend pas en charge les tâches GPU pour AWS Batch. Pour plus d'informations, consultez la section [Tâches GPU](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html). ## Arguments positionnels ***command*** Soumet la tâche (la commande spécifiée doit être disponible sur les instances de calcul) ou le nom du fichier à transférer. Consultez également `--command-file`. **arguments** (Facultatif) Spécifie les arguments de la commande ou du fichier de commandes. ## Arguments nommés **-jn *JOB\$1NAME*, --job-name *JOB\$1NAME*** Nom de la tâche. Le premier caractère doit être une lettre ou un chiffre. Le nom du travail peut contenir des lettres (majuscules et minuscules), des chiffres, des traits d'union et des traits de soulignement, et comporter jusqu'à 128 caractères. **-c *CLUSTER*, --cluster *CLUSTER*** Spécifie le cluster à utiliser. **-cf, --command-file** Indique que la commande est un fichier à transférer aux instances de calcul. Par défaut : false **-w *WORKING\$1DIR*, --working-dir *WORKING\$1DIR*** Spécifie le dossier à utiliser en tant que répertoire de travail des tâches. Si aucun répertoire de travail n'est spécifié, la tâche est exécutée dans le `job-` sous-dossier du répertoire personnel de l'utilisateur. Vous pouvez utiliser ce paramètre ou le paramètre `--parent-working-dir`. **-pw *PARENT\$1WORKING\$1DIR*, --parent-working-dir *PARENT\$1WORKING\$1DIR*** Spécifie le dossier parent du répertoire de travail de la tâche. Si aucun répertoire de travail parent n'est spécifié, il s'agit par défaut du répertoire personnel de l'utilisateur. Un sous-dossier nommé `job-` est créé dans le répertoire de travail parent. Vous pouvez utiliser ce paramètre ou le paramètre `--working-dir`. **-if *INPUT\$1FILE*, --input-file *INPUT\$1FILE*** Spécifie le fichier à transférer vers les instances de calcul, dans le répertoire de travail de la tâche. Vous pouvez spécifier plusieurs paramètres de fichiers d'entrée. **-p *VCPUS*, --vcpus *VCPUS*** Spécifie le nombre de v CPUs à réserver pour le conteneur. Lorsqu'il est utilisé avec`–nodes`, il identifie le nombre de v CPUs pour chaque nœud. Valeur par défaut : 1 **-m *MEMORY*, --memory *MEMORY*** Spécifie la limite stricte de la mémoire (en Mio) à fournir pour la tâche. Si votre tâche tente de dépasser la limite de mémoire spécifiée ici, elle est terminée. Valeur par défaut : 128 **-e *ENV*, --env *ENV*** Spécifie une liste de noms de variables d'environnement séparés par des virgules à exporter vers l'environnement de la tâche. Pour exporter toutes les variables d'environnement, spécifiez « all ». Notez qu'une liste de « toutes » les variables d'environnement n'inclut pas celles répertoriées dans le `–env-blacklist` paramètre, ni les variables commençant par le `AWS_*` préfixe `PCLUSTER_*` ou. **-eb *ENV\$1DENYLIST*, --env-blacklist *ENV\$1DENYLIST*** Spécifie une liste de noms de variable d'environnement séparés par des virgules à **ne pas** exporter vers l'environnement de la tâche. Par défaut, `HOME`, `PWD`, `USER`, `PATH`, `LD_LIBRARY_PATH`, `TERM` et `TERMCAP` ne sont pas exportées. **-r *RETRY\$1ATTEMPTS*, --retry-attempts *RETRY\$1ATTEMPTS*** Spécifie le nombre de fois qu'une tâche doit passer au `RUNNABLE` statut. Vous pouvez indiquer entre 1 et 10 tentatives. Si la valeur des tentatives est supérieure à 1, la tâche est réessayée en cas d'échec, jusqu'à ce qu'elle passe à un `RUNNABLE` statut pour le nombre de fois spécifié. Valeur par défaut : 1 **-t *TIMEOUT*, --timeout *TIMEOUT*** Spécifie la durée en secondes (mesurée à partir de l'`startedAt`horodatage de la tentative de travail) après laquelle votre tâche s' AWS Batch arrête si elle n'est pas terminée. La valeur du délai d'expiration doit être au moins égal à 60 secondes. **-n *NODES*, --nodes *NODES*** Spécifie le nombre de nœuds à réserver pour la tâche. Spécifiez une valeur pour ce paramètre afin d'activer la soumission parallèle sur plusieurs nœuds. Les tâches parallèles à nœuds multiples ne sont pas prises en charge lorsque le [`cluster_type`](cluster-definition.md#cluster-type) paramètre est défini sur. `spot` **-a *ARRAY\$1SIZE*, --array-size *ARRAY\$1SIZE*** Indique la taille du tableau. Vous pouvez spécifier une valeur comprise entre 2 et 10 000. Si vous spécifiez les propriétés de tableau pour une tâche, elle devient une tâche de tableau. **-d *DEPENDS\$1ON*, --depends-on *DEPENDS\$1ON*** Spécifie une liste de dépendances séparées par un point-virgule pour une tâche. Une tâche peut compter jusqu’à 20 tâches au plus. Vous pouvez spécifier une dépendance `SEQUENTIAL` de type sans spécifier d'ID de tâche pour les tâches matricielles. Une dépendance séquentielle permet à chaque tâche de tableau enfant de se terminer de manière séquentielle, à partir de l'index 0. Vous pouvez également spécifier une dépendance de type N\$1TO\$1N avec un ID de tâche pour les tâches de tableau. Une dépendance N\$1TO\$1N signifie que chaque enfant de l'index de cette tâche doit attendre que l'enfant de l'index correspondant de chaque dépendance soit terminé avant de pouvoir commencer. La syntaxe de ce paramètre est « jobID=**, type= ** ;... ». # `awsbstat` Affiche les tâches soumises dans la file d'attente des tâches du cluster. ``` awsbstat [-h] [-c CLUSTER] [-s STATUS] [-e] [-d] [job_ids [job_ids ...]] ``` ## Arguments positionnels ***job\$1ids*** Spécifie la liste des tâches séparées par des espaces IDs à afficher dans la sortie. Si la tâche est un tableau de tâches, toutes les tâches enfants sont affichées. Si une tâche unique est demandée, elle apparaît dans une version détaillée. ## Arguments nommés **-c *CLUSTER*, --cluster *CLUSTER*** Indique le cluster à utiliser. **-s *STATUS*, --status *STATUS*** Spécifie la liste des statuts de tâche séparés par une virgule à inclure. Par défaut, le statut de la tâche est « active ». Les valeurs acceptées sont : `SUBMITTED`, `PENDING`, `RUNNABLE`, `STARTING`, `RUNNING`, `SUCCEEDED`, `FAILED` et `ALL`. Par défaut : « `SUBMITTED`,`PENDING`,`RUNNABLE`,`STARTING`,`RUNNING` » **-e, --expand-children** Étend les tâches avec enfants (tableau et parallèle à plusieurs nœuds). Par défaut : false **-d, --details** Affiche les détails des tâches. Par défaut : false # `awsbout` Affiche la sortie d'une tâche donnée. ``` awsbout [ - h ] [ - c CLUSTER ] [ - hd HEAD ] [ - t TAIL ] [ - s ] [ - sp STREAM_PERIOD ] job_id ``` ## Arguments positionnels ***job\$1id*** Spécifie l'ID de tâche. ## Arguments nommés **-c *CLUSTER*, --cluster *CLUSTER*** Indique le cluster à utiliser. **-hd *HEAD*, --head *HEAD*** Obtient les premières *HEAD* lignes du résultat de la tâche. **-t *TAIL*, --tail *TAIL*** Permet d'obtenir les dernières lignes de la sortie de tâche. **-s, --stream** Permet d'obtenir la sortie de tâche, puis attend qu’une sortie supplémentaire soit produite. Cet argument peut être utilisé avec -tail pour démarrer à partir des dernières lignes de la sortie de tâche. Par défaut : false **-sp *STREAM\$1PERIOD*, --stream-period *STREAM\$1PERIOD*** Définit la période de streaming. Par défaut: 5 # `awsbkill` Annule ou met fin à des tâches soumises dans le cluster. ``` awsbkill [ - h ] [ - c CLUSTER ] [ - r REASON ] job_ids [ job_ids ... ] ``` ## Arguments positionnels ***job\$1ids*** Spécifie la liste séparée par des espaces des tâches IDs à annuler ou à terminer. ## Arguments nommés **-c *CLUSTER*, --cluster *CLUSTER*** Indique le nom du cluster à utiliser. **-r *REASON*, --reason *REASON*** Indique le message que vous souhaitez attacher à une tâche, en expliquant la raison de l'annulation. Par défaut : « Terminated by the user » # `awsbqueues` Affiche la file d'attente de tâches associée au cluster. ``` awsbqueues [ - h ] [ - c CLUSTER ] [ - d ] [ job_queues [ job_queues ... ]] ``` ## Arguments positionnels ***job\$1queues*** Spécifie la liste des noms de file d'attente séparés par des espaces à afficher. Si une seule file d'attente est demandée, elle est affichée dans une version détaillée. ## Arguments nommés **-c *CLUSTER*, --cluster *CLUSTER*** Spécifie le nom du cluster à utiliser. **-d, --details** Indique s'il convient d'afficher les détails des files d'attente. Par défaut : false # `awsbhosts` Affiche les hôtes qui appartiennent à l'environnement de calcul du cluster. ``` awsbhosts [ - h ] [ - c CLUSTER ] [ - d ] [ instance_ids [ instance_ids ... ]] ``` ## Arguments positionnels ***instance\$1ids*** Spécifie une liste d'instances séparées par des espaces. IDs Si une seule instance est demandée, elle apparaît dans une version détaillée. ## Arguments nommés **-c *CLUSTER*, --cluster *CLUSTER*** Spécifie le nom du cluster à utiliser. **-d, --details** Indique s'il convient d'afficher les détails des hôtes. Par défaut : false