awsbsub

Envía trabajos a la cola de trabajos del clúster.

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 ...]]

importante

AWS ParallelCluster no admite trabajos de GPU para AWS Batch. Para obtener más información, consulte Trabajos de la GPU.

Argumentos de posición

command

Envía el trabajo (el comando especificado debe estar disponible en las instancias de computación) o el nombre de archivo que se va a transferir. Véase también --command-file.

arguments

(Opcional) Especifica argumentos para el comando o el archivo de comandos.

Argumentos con nombre

-jn JOB_NAME, --job-name JOB_NAME

Asigna un nombre al trabajo. El primer carácter debe ser una letra o un número. El nombre del trabajo puede contener letras (mayúsculas y minúsculas), números, guiones (-) y guiones bajos (_), y puede tener una longitud máxima de 128 caracteres.

-c CLUSTER, --cluster CLUSTER

Especifica el clúster que se va a utilizar.

-cf, --command-file

Indica que el comando es una archivo que se va a transferir a las instancias de informática.

Valor predeterminado: False

-w WORKING_DIR, --working-dir WORKING_DIR

Especifica la carpeta que se va a usar como directorio de trabajo del trabajo. Si no se especifica un directorio de trabajo, el trabajo se ejecuta en la subcarpeta job-<AWS_BATCH_JOB_ID> del directorio de inicio del usuario. Puede utilizar este parámetro o el parámetro --parent-working-dir.

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

Especifica la carpeta principal del directorio de trabajo del trabajo. Si no se especifica un directorio de trabajo principal, el valor predeterminado es el directorio de inicio del usuario. Una subcarpeta llamada job-<AWS_BATCH_JOB_ID> se crea en el directorio de trabajo principal. Puede utilizar este parámetro o el parámetro --working-dir.

-if INPUT_FILE, --input-file INPUT_FILE

Especifica el archivo que se va a transferir a las instancias de computación, en el directorio de trabajo de la tarea. Puede especificar varios parámetros de archivo de entrada.

-p VCPUS, --vcpus VCPUS

Especifica la cantidad de CPU virtuales que quiere reservar para el contenedor. Cuando se utiliza junto con –nodes, identifica la cantidad de vCPU por cada nodo.

Predeterminado: 1

-m MEMORY, --memory MEMORY

Especifica el límite máximo de memoria (en MiB) que se va a proporcionar para el trabajo. Si su trabajo intenta superar el límite de memoria especificado aquí, se finaliza el trabajo.

Predeterminado: 128

-e ENV, --env ENV

Especifica una lista de nombres de variable de entorno separados por comas que se van a exportar al entorno de trabajo. Para exportar todas las variables de entorno, especifique "todas". Tenga en cuenta que una lista de “todas” las variables de entorno no incluyen aquellas que figuren en el parámetro –env-blacklist ni tampoco variables que empiecen por el prefijo PCLUSTER_* o AWS_*.

-eb ENV_DENYLIST, --env-blacklist ENV_DENYLIST

Especifica una lista de nombres de variable de entorno separados por comas que no se van a exportar al entorno de trabajo. De forma predeterminada, no se exportan HOME, PWD, USER, PATH, LD_LIBRARY_PATH, TERM ni TERMCAP.

-r RETRY_ATTEMPTS, --retry-attempts RETRY_ATTEMPTS

Especifica la cantidad de veces que toma pasar un trabajo al estado RUNNABLE. Puede especificar entre 1 y 10 intentos. Si el valor de los intentos es superior a 1, el trabajo se reintenta si produce un error, hasta que haya pasado al estado RUNNABLE, que especificaba la cantidad de veces.

Predeterminado: 1

-t TIMEOUT, --timeout TIMEOUT

Especifica la duración en segundos (medida a partir de la marca de tiempo startedAt del intento de trabajo) después de la cual AWS Batch termina el trabajo si no ha finalizado. El valor del tiempo de inactividad debe ser al menos 60 segundos.

-n NODES, --nodes NODES

Especifica el número de nodos que quiere reservar para el trabajo. Especifique un valor para que este parámetro habilite el envío paralelo de varios nodos.

nota

Cuando el parámetro Scheduler/AwsBatchQueues/CapacityType está establecido en SPOT, no se admiten los trabajos paralelos de varios nodos. Además, debe haber un rol vinculado a servicios AWSServiceRoleForEC2Spot en su cuenta. Puede crear este rol con el siguiente comando de AWS CLI:

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

Para obtener más información, consulte Rol vinculado al servicio para solicitudes de instancias de spot en la Guía del usuario de Amazon EC2 para instancias de Linux.

-a ARRAY_SIZE, --array-size ARRAY_SIZE

Indica el tamaño de la matriz. Puede especificar un valor comprendido entre 2 y 10 000. Si especifica las propiedades de matriz para un trabajo, pasa a ser un trabajo de matriz.

-d DEPENDS_ON, --depends-on DEPENDS_ON

Especifica una lista de dependencias separadas por puntos y coma para un trabajo. Un trabajo puede depender de un máximo de 20 trabajos. Puede especificar una dependencia de tipo SEQUENTIAL sin especificar un ID de trabajo para los trabajos de matriz. Una dependencia SEQUENTIAL permite que cada trabajo de matriz secundario se complete de forma secuencial, a partir del índice 0. También puede especificar una dependencia de tipo N_TO_N con un ID de trabajo para los trabajos de matriz. Una dependencia N_TO_N conlleva que cada índice secundario de este trabajo deba esperar a que se complete el índice secundario correspondiente de cada dependencia antes de comenzar. La sintaxis de este parámetro es “jobId=<string>,type=<string>;...”.