StartTask interface
Em alguns casos, a tarefa de início pode ser novamente executada, mesmo que o nó não tenha sido reiniciado. Devido a isto, as tarefas de início devem ser idempotentes e sair corretamente se a configuração que estão a executar já tiver sido efetuada. Deve ter especial cuidado para evitar iniciar tarefas que criam processos de separação ou instalam/iniciam serviços a partir do diretório de trabalho da tarefa inicial, uma vez que isto impedirá o Batch de voltar a executar a tarefa de início.
Propriedades
command |
A linha de comandos não é executada numa shell e, por conseguinte, não pode tirar partido das funcionalidades da shell, como a expansão da variável de ambiente. Se quiser tirar partido destas funcionalidades, deve invocar a shell na linha de comandos, por exemplo, utilizando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Necessário se forem especificadas outras propriedades do startTask. |
container |
Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz de Azure Batch diretórios no nó) são mapeados para o contentor, todas as variáveis de ambiente de tarefas são mapeadas para o contentor e a linha de comandos da tarefa é executada no contentor. |
environment |
Uma lista de definições de variáveis de ambiente para a tarefa de início. |
max |
O serviço Batch repetirá uma tarefa se o código de saída não for zero. Tenha em atenção que este valor controla especificamente o número de repetições. O serviço Batch tentará a tarefa uma vez e, em seguida, poderá repetir até este limite. Por exemplo, se a contagem máxima de repetições for 3, o Batch tenta a tarefa até 4 vezes (uma tentativa inicial e três repetições). Se a contagem máxima de repetições for 0, o serviço Batch não repetirá a tarefa. Se a contagem máxima de repetições for -1, o serviço Batch repetirá a tarefa sem limite. A predefinição é 0 |
resource |
Uma lista de ficheiros que o serviço Batch irá transferir para o nó de computação antes de executar a linha de comandos. |
user |
Se for omitida, a tarefa é executada como um utilizador não administrativo exclusivo da tarefa. |
wait |
Se for verdadeiro e a tarefa de início falhar num nó de computação, o serviço Batch repete a tarefa de início até à contagem máxima de repetições (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as repetições, o serviço Batch marca o nó de computação inutilizável e não agendará tarefas para o mesmo. Esta condição pode ser detetada através do estado do nó e do detalhe do erro de agendamento. Se for falso, o serviço Batch não aguardará que a tarefa de início seja concluída. Neste caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa de início ainda está em execução; e mesmo que a tarefa de início falhe, as novas tarefas continuarão a ser agendadas no nó. A predefinição é verdadeira. |
Detalhes de Propriedade
commandLine
A linha de comandos não é executada numa shell e, por conseguinte, não pode tirar partido das funcionalidades da shell, como a expansão da variável de ambiente. Se quiser tirar partido destas funcionalidades, deve invocar a shell na linha de comandos, por exemplo, utilizando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Necessário se forem especificadas outras propriedades do startTask.
commandLine?: string
Valor de Propriedade
string
containerSettings
Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz de Azure Batch diretórios no nó) são mapeados para o contentor, todas as variáveis de ambiente de tarefas são mapeadas para o contentor e a linha de comandos da tarefa é executada no contentor.
containerSettings?: TaskContainerSettings
Valor de Propriedade
environmentSettings
Uma lista de definições de variáveis de ambiente para a tarefa de início.
environmentSettings?: EnvironmentSetting[]
Valor de Propriedade
maxTaskRetryCount
O serviço Batch repetirá uma tarefa se o código de saída não for zero. Tenha em atenção que este valor controla especificamente o número de repetições. O serviço Batch tentará a tarefa uma vez e, em seguida, poderá repetir até este limite. Por exemplo, se a contagem máxima de repetições for 3, o Batch tenta a tarefa até 4 vezes (uma tentativa inicial e três repetições). Se a contagem máxima de repetições for 0, o serviço Batch não repetirá a tarefa. Se a contagem máxima de repetições for -1, o serviço Batch repetirá a tarefa sem limite. A predefinição é 0
maxTaskRetryCount?: number
Valor de Propriedade
number
resourceFiles
Uma lista de ficheiros que o serviço Batch irá transferir para o nó de computação antes de executar a linha de comandos.
resourceFiles?: ResourceFile[]
Valor de Propriedade
userIdentity
Se for omitida, a tarefa é executada como um utilizador não administrativo exclusivo da tarefa.
userIdentity?: UserIdentity
Valor de Propriedade
waitForSuccess
Se for verdadeiro e a tarefa de início falhar num nó de computação, o serviço Batch repete a tarefa de início até à contagem máxima de repetições (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as repetições, o serviço Batch marca o nó de computação inutilizável e não agendará tarefas para o mesmo. Esta condição pode ser detetada através do estado do nó e do detalhe do erro de agendamento. Se for falso, o serviço Batch não aguardará que a tarefa de início seja concluída. Neste caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa de início ainda está em execução; e mesmo que a tarefa de início falhe, as novas tarefas continuarão a ser agendadas no nó. A predefinição é verdadeira.
waitForSuccess?: boolean
Valor de Propriedade
boolean