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 ParallelClusterne prend pas en charge les tâches GPU pourAWS Batch. Pour plus d'informations, consultez Tâches de traitement des cartes obliques.

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. Voir aussi --command-file.

arguments

(Facultatif) Spécifie les arguments de la commande ou du fichier de commandes.

Arguments nommés

-jn JOB_NAME, --job-name JOB_NAME

Nom de la tâche. Le premier caractère doit être une lettre ou un chiffre. Le nom de tâche peut comporter des lettres (majuscules et minuscules), des chiffres, des tirets ou des traits de soulignement.

-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_DIR, --working-dir WORKING_DIR

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 lejob-<AWS_BATCH_JOB_ID> sous-dossier du répertoire personnel de l'utilisateur. Vous pouvez utiliser ce paramètre ou le paramètre --parent-working-dir.

-pw PARENT_WORKING_DIR, --parent-working-dir PARENT_WORKING_DIR

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 de base de l'utilisateur. Un sous-dossier nommé job-<AWS_BATCH_JOB_ID> est créé dans le répertoire de travail parent. Vous pouvez utiliser ce paramètre ou le paramètre --working-dir.

-if INPUT_FILE, --input-file INPUT_FILE

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 processeurs virtuels à réserver pour le conteneur. Lorsqu'il est utilisé avec–nodes, il identifie le nombre de vCPUs pour chaque nœud.

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 mémoire spécifiée ici, elle sera désactivé.

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 leAWS_* préfixePCLUSTER_* ou.

-eb ENV_DENYLIST, --env-blacklist ENV_DENYLIST

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_ATTEMPTS, --retry-attempts RETRY_ATTEMPTS

Spécifie le nombre de fois où une tâche est passée enRUNNABLE 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 soit passée auRUNNABLE statut spécifié pour le nombre de fois spécifié.

Par défaut: 1

-t TIMEOUT, --timeout TIMEOUT

Spécifie la durée en secondes (mesurée à partir de l'startedAthorodatage de la tentativeAWS Batch de tâche) après laquelle votre tâche sera désactivé. 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 parallel sur plusieurs nœuds.

Note

Lorsque le CapacityTypeparamètre Scheduler/AwsBatchQueues/est défini surSPOT, les tâches parallel à nœuds multiples ne sont pas prises en charge. De plus, votre compte doitAWSServiceRoleForEC2Spot comporter un rôle lié à un service. Vous pouvez créer ce rôle à l'aide de laAWS CLI commande suivante :

$ aws iam create-service-linked-role --aws-service-name spot.amazonaws.com

Pour plus d'informations, consultez Rôle lié à un service pour les demandes d'instance Spot dans le Guide de l'utilisateur Amazon EC2 pour les instances Linux.

-a ARRAY_SIZE, --array-size ARRAY_SIZE

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_ON, --depends-on DEPENDS_ON

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épendanceSEQUENTIAL de type sans spécifier d'ID de tâche pour les tâches de tableau. 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_TO_N avec un ID de tâche pour les tâches de tableau. Une dépendance N_TO_N 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=<string>, type= <string>;... ».