As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # AWS Batch (`awsbatch`) AWS Batch Para obter informações sobre AWS Batch, consulte [AWS Batch](https://aws.amazon.com/batch/). Para obter a documentação, consulte o [Guia do usuário do AWS Batch](https://docs.aws.amazon.com/batch/latest/userguide/). **AWS ParallelCluster Comandos CLI para AWS Batch** Quando você usa o `awsbatch` agendador, os comandos da AWS ParallelCluster CLI AWS Batch para são instalados automaticamente no nó AWS ParallelCluster principal. A CLI usa operações de AWS Batch API e permite as seguintes operações: + Enviar e gerenciar trabalhos. + Monitorar trabalhos, filas e hosts. + Espelhar comandos do programador tradicional. **Importante** AWS ParallelCluster não suporta trabalhos de GPU para AWS Batch. Para obter mais informações, consulte [Trabalhos de 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` Envia trabalhos para a fila de trabalhos do 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 ...]] ``` **Importante** AWS ParallelCluster não suporta trabalhos de GPU para AWS Batch. Para obter mais informações, consulte [Trabalhos de GPU](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html). ## Argumentos posicionais ***command*** Envia o trabalho (o comando especificado deve estar disponível nas instâncias de computação) ou o nome do arquivo a ser transferido. Consulte também `--command-file`. **arguments** (Opcional) Especifica argumentos para o comando ou arquivo de comando. ## Argumentos nomeados **-jn *JOB\$1NAME*, --job-name *JOB\$1NAME*** Nomeia a tarefa. O primeiro caractere deve ser uma letra ou um número. O nome do trabalho pode conter letras (minúsculas e maiúsculas), números, hifens e sublinhados, e ter até 128 caracteres de comprimento. **-c *CLUSTER*, --cluster *CLUSTER*** Especifica o cluster a ser usado. **-cf, --command-file** Indica que o comando é um arquivo a ser transferido para as instâncias de computação. Padrão: False **-w *WORKING\$1DIR*, --working-dir *WORKING\$1DIR*** Especifica a pasta a ser usada como diretório de trabalho da tarefa. Se um diretório de trabalho não for especificado, o trabalho será executado na subpasta `job-` do diretório inicial do usuário. Você pode usar esse parâmetro ou o parâmetro `--parent-working-dir`. **-pw *PARENT\$1WORKING\$1DIR*, --parent-working-dir *PARENT\$1WORKING\$1DIR*** Especifica a pasta pai do diretório de trabalho da tarefa. Se um diretório de trabalho pai não for especificado, o padrão será o diretório inicial do usuário. Uma subpasta chamada `job-` será criada no diretório de trabalho pai. Você pode usar esse parâmetro ou o parâmetro `--working-dir`. **-if *INPUT\$1FILE*, --input-file *INPUT\$1FILE*** Especifica o arquivo a ser transferido para as instâncias de computação, no diretório de trabalho do trabalho. Você pode especificar vários parâmetros de arquivo de entrada. **-p *VCPUS*, --vcpus *VCPUS*** Especifica o número de v CPUs a ser reservado para o contêiner. Quando usado junto com`–nodes`, ele identifica o número de v CPUs para cada nó. Padrão: 1 **-m *MEMORY*, --memory *MEMORY*** Especifica o limite rígido de memória (em MiB) a ser fornecido para a tarefa. Se o trabalho tentar exceder o limite de memória especificado aqui, ele será encerrado. Padrão: 128 **-e *ENV*, --env *ENV*** Especifica uma lista separada por vírgulas dos nomes das variáveis de ambiente a serem exportadas para o ambiente da tarefa. Para exportar todas as variáveis de ambiente, especifique "all". Observe que uma lista de variáveis de ambiente "all" não inclui as listadas no parâmetro `–env-blacklist`, nem variáveis que começam com os prefixos `PCLUSTER_*` e `AWS_*`. **-eb *ENV\$1DENYLIST*, --env-blacklist *ENV\$1DENYLIST*** Especifica uma lista separada por vírgulas dos nomes das variáveis de ambiente a **não** serem exportadas para o ambiente da tarefa. Por padrão, `HOME`, `PWD`, `USER`, `PATH`, `LD_LIBRARY_PATH`, `TERM` e `TERMCAP` não são exportadas. **-r *RETRY\$1ATTEMPTS*, --retry-attempts *RETRY\$1ATTEMPTS*** Especifica o número de vezes que um trabalho será movido para o status `RUNNABLE`. Você pode especificar entre 1 e 10 tentativas. Se o valor de tentativas for maior que 1, o trabalho será repetido se falhar, até ser movido para um status `RUNNABLE` esse número especificado de vezes. Padrão: 1 **-t *TIMEOUT*, --timeout *TIMEOUT*** Especifica a duração em segundos (medida a partir do `startedAt` carimbo de data/hora da tentativa de trabalho) após a qual AWS Batch encerra seu trabalho se ele não tiver sido concluído. O valor de tempo limite deve ser pelo menos 60 segundos. **-n *NODES*, --nodes *NODES*** Especifica o número de nós a serem reservados para a tarefa. Especifique um valor para esse parâmetro a fim de habilitar o envio paralelo com vários nós. Trabalhos paralelos de vários nós não são compatíveis quando o parâmetro [`cluster_type`](cluster-definition.md#cluster-type) é definido como `spot`. **-a *ARRAY\$1SIZE*, --array-size *ARRAY\$1SIZE*** Indica o tamanho da matriz. Você pode especificar um valor entre 2 e 10.000. Se você especificar propriedades de matriz para uma tarefa, ela se torna uma tarefa de matriz. **-d *DEPENDS\$1ON*, --depends-on *DEPENDS\$1ON*** Especifica uma lista de dependências separadas por ponto-e-vírgula para uma tarefa. Uma tarefa pode depender de, no máximo, outras 20 tarefas. Você pode especificar um tipo de dependência `SEQUENTIAL` sem especificar um ID de trabalho para trabalhos de matriz. Uma dependência sequencial permite que cada tarefa filho da matriz seja concluída sequencialmente, a partir do índice 0. Você também pode especificar uma dependência do tipo N\$1TO\$1N com um ID de tarefa para tarefas de matriz. Uma dependência N\$1TO\$1N significa que cada índice filho dessa tarefa precisa aguardar que o índice filho correspondente de cada dependência seja concluído antes de poder começar. A sintaxe desse parâmetro é “jobId=**, type=**;...”. # `awsbstat` Mostra as tarefas que são enviadas na fila de tarefas do cluster. ``` awsbstat [-h] [-c CLUSTER] [-s STATUS] [-e] [-d] [job_ids [job_ids ...]] ``` ## Argumentos posicionais ***job\$1ids*** Especifica a lista de trabalhos separados por espaços IDs a serem mostrados na saída. Se o trabalho for uma matriz de trabalhos, todos os trabalhos filho são exibidos. Se uma única tarefa for solicitada, seus detalhes são exibidos. ## Argumentos nomeados **-c *CLUSTER*, --cluster *CLUSTER*** Indica o cluster a ser usado. **-s *STATUS*, --status *STATUS*** Especifica uma lista separada por vírgulas de status de tarefa a ser incluída. O status de tarefa padrão é "ativo". Os valores aceitos são: `SUBMITTED`, `PENDING`, `RUNNABLE`, `STARTING`, `RUNNING`, `SUCCEEDED`, `FAILED` e `ALL`. Padrão: “`SUBMITTED`,`PENDING`,`RUNNABLE`,`STARTING`,`RUNNING`” **-e, --expand-children** Expande tarefas com filhos (matriz e paralelo com vários nós). Padrão: False **-d, --details** Mostra os detalhes da tarefa. Padrão: False # `awsbout` Mostra a saída de uma tarefa específica. ``` awsbout [ - h ] [ - c CLUSTER ] [ - hd HEAD ] [ - t TAIL ] [ - s ] [ - sp STREAM_PERIOD ] job_id ``` ## Argumentos posicionais ***job\$1id*** Especifica o ID da tarefa. ## Argumentos nomeados **-c *CLUSTER*, --cluster *CLUSTER*** Indica o cluster a ser usado. **-hd *HEAD*, --head *HEAD*** Obtém as primeiras *HEAD* linhas da saída do trabalho. **-t *TAIL*, --tail *TAIL*** Obtém as últimas linhas da saída da tarefa. **-s, --stream** Obtém a saída da tarefa e aguarda a saída adicional que será produzida. Esse argumento pode ser usado em conjunto com –tail para iniciar a partir das últimas linhas da saída da tarefa. Padrão: False **-sp *STREAM\$1PERIOD*, --stream-period *STREAM\$1PERIOD*** Define o período de streaming. Padrão: 5 # `awsbkill` Cancela ou encerra tarefas enviadas no cluster. ``` awsbkill [ - h ] [ - c CLUSTER ] [ - r REASON ] job_ids [ job_ids ... ] ``` ## Argumentos posicionais ***job\$1ids*** Especifica a lista de trabalhos separados por espaços a IDs serem cancelados ou encerrados. ## Argumentos nomeados **-c *CLUSTER*, --cluster *CLUSTER*** Indica o nome do cluster a ser usado. **-r *REASON*, --reason *REASON*** Indica a mensagem que será anexada a uma tarefa, explicando o motivo do cancelamento. Padrão: “Terminated by the user” # `awsbqueues` Mostra a fila de tarefas associada ao cluster. ``` awsbqueues [ - h ] [ - c CLUSTER ] [ - d ] [ job_queues [ job_queues ... ]] ``` ## Argumentos posicionais ***job\$1queues*** Especifica a lista separada por espaços de nomes de fila a ser exibida. Se uma única fila for solicitada, seus detalhes são exibidos. ## Argumentos nomeados **-c *CLUSTER*, --cluster *CLUSTER*** Especifica o nome do cluster a ser usado. **-d, --details** Indica se deve mostrar os detalhes das filas. Padrão: False # `awsbhosts` Mostra os hosts que pertencem ao ambiente de computação do cluster. ``` awsbhosts [ - h ] [ - c CLUSTER ] [ - d ] [ instance_ids [ instance_ids ... ]] ``` ## Argumentos posicionais ***instance\$1ids*** Especifica uma lista de instâncias separadas por espaços. IDs Se uma única instância for solicitada, seus detalhes são exibidos. ## Argumentos nomeados **-c *CLUSTER*, --cluster *CLUSTER*** Especifica o nome do cluster a ser usado. **-d, --details** Indica se deve mostrar os detalhes dos hosts. Padrão: False