StartTask interface
Em alguns casos, a tarefa inicial pode ser executada novamente, mesmo que o nó não tenha sido reinicializado. Devido a isso, as tarefas de início devem ser idempotentes e sair normalmente se a configuração que estão executando já tiver sido feita. Deve-se tomar cuidado especial para evitar tarefas iniciais que criam processos de interrupção ou serviços de instalação/inicialização do diretório de trabalho da tarefa inicial, pois isso impedirá que o Lote seja capaz de executar novamente a tarefa inicial.
Propriedades
command |
A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se você quiser aproveitar esses recursos, invoque o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Obrigatório se outras propriedades do startTask forem especificadas. |
container |
Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz de Lote do Azure diretórios no nó) são mapeados para o contêiner, todas as variáveis de ambiente de tarefa são mapeadas para o contêiner e a linha de comando da tarefa é executada no contêiner. |
environment |
Uma lista de configurações de variável de ambiente para a tarefa inicial. |
max |
O serviço em lotes repetirá uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em lotes tentará a tarefa uma vez e, em seguida, pode tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetições for 3, o Lote tentará a tarefa até 4 vezes (uma tentativa inicial e três novas tentativas). Se a contagem máxima de repetições for 0, o serviço do Lote não repetirá a tarefa. Se a contagem máxima de repetições for -1, o serviço do Lote repetirá a tarefa sem limite. O padrão é 0 |
resource |
Uma lista de arquivos que o serviço do Lote baixará para o nó de computação antes de executar a linha de comando. |
user |
Se omitida, a tarefa será executada como um usuário não administrativo exclusivo da tarefa. |
wait |
Se true e a tarefa inicial falharem em um nó de computação, o serviço do Lote tentará novamente a tarefa inicial até sua contagem máxima de repetição (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço lote marcará o nó de computação inutilizável e não agendará tarefas para ela. Essa condição pode ser detectada por meio do estado do nó e dos detalhes do erro de agendamento. Se for false, o serviço do Lote não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; e mesmo que a tarefa inicial falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é true. |
Detalhes da propriedade
commandLine
A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se você quiser aproveitar esses recursos, invoque o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Obrigatório se outras propriedades do startTask forem especificadas.
commandLine?: string
Valor da propriedade
string
containerSettings
Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz de Lote do Azure diretórios no nó) são mapeados para o contêiner, todas as variáveis de ambiente de tarefa são mapeadas para o contêiner e a linha de comando da tarefa é executada no contêiner.
containerSettings?: TaskContainerSettings
Valor da propriedade
environmentSettings
Uma lista de configurações de variável de ambiente para a tarefa inicial.
environmentSettings?: EnvironmentSetting[]
Valor da propriedade
maxTaskRetryCount
O serviço em lotes repetirá uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em lotes tentará a tarefa uma vez e, em seguida, pode tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetições for 3, o Lote tentará a tarefa até 4 vezes (uma tentativa inicial e três novas tentativas). Se a contagem máxima de repetições for 0, o serviço do Lote não repetirá a tarefa. Se a contagem máxima de repetições for -1, o serviço do Lote repetirá a tarefa sem limite. O padrão é 0
maxTaskRetryCount?: number
Valor da propriedade
number
resourceFiles
Uma lista de arquivos que o serviço do Lote baixará para o nó de computação antes de executar a linha de comando.
resourceFiles?: ResourceFile[]
Valor da propriedade
userIdentity
Se omitida, a tarefa será executada como um usuário não administrativo exclusivo da tarefa.
userIdentity?: UserIdentity
Valor da propriedade
waitForSuccess
Se true e a tarefa inicial falharem em um nó de computação, o serviço do Lote tentará novamente a tarefa inicial até sua contagem máxima de repetição (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço lote marcará o nó de computação inutilizável e não agendará tarefas para ela. Essa condição pode ser detectada por meio do estado do nó e dos detalhes do erro de agendamento. Se for false, o serviço do Lote não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; e mesmo que a tarefa inicial falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é true.
waitForSuccess?: boolean
Valor da propriedade
boolean