Compartilhar via


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

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.

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.

environmentSettings

Uma lista de configurações de variável de ambiente para a tarefa inicial.

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

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.

userIdentity

Se omitida, a tarefa será executada como um usuário não administrativo exclusivo da tarefa.

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.

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