Sdílet prostřednictvím

StartTask interface

  • Reference
Balíček:
@azure/arm-batch

V některých případech může být spouštěcí úloha znovu spuštěna, i když se uzel nerestartoval. Z tohoto důvodu by spouštěcí úlohy měly být idempotentní a měly by se řádně ukončit, pokud už bylo provedeno nastavení, které provádějí. Zvláštní pozornost je třeba věnovat tomu, abyste se vyhnuli spouštěcím úlohám, které vytvářejí přerušovaný proces nebo instalují nebo spouštějí služby z pracovního adresáře spouštěcího úkolu, protože tím se službě Batch zablokuje možnost znovu spustit spouštěcí úkol.

Vlastnosti

commandLine

Příkazový řádek se nespouští v prostředí, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd /c MyCommand" ve Windows nebo "/bin/sh -c MyCommand" v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli jiné vlastnosti startTask.
containerSettings

Při zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) namapují do kontejneru, všechny proměnné prostředí úkolů se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru.
environmentSettings

Seznam nastavení proměnných prostředí pro spouštěcí úlohu.
maxTaskRetryCount

Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakovaných pokusů. Služba Batch úkol jednou vyzkouší a až do tohoto limitu se může opakovat. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch úlohu opakovat nebude. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení. Výchozí hodnota je 0.
resourceFiles

Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku.
userIdentity

Pokud ho vynecháte, spustí se jako uživatel bez oprávnění správce, který je pro danou úlohu jedinečný.
waitForSuccess

Pokud je hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje opakování spouštěcího úkolu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol ani po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje pro něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o chybách plánování. Pokud je hodnota false, služba Batch nebude čekat na dokončení spouštěcího úkolu. V takovém případě mohou být na výpočetním uzlu spuštěny další úkoly, zatímco spouštěcí úkol je stále spuštěný. a i když se spouštěcí úkol nezdaří, nové úkoly budou i nadále naplánovány na uzlu. Výchozí hodnota je true.

Podrobnosti vlastnosti

commandLine

Příkazový řádek se nespouští v prostředí, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd /c MyCommand" ve Windows nebo "/bin/sh -c MyCommand" v Linuxu. Vyžaduje se, pokud jsou zadány jakékoli jiné vlastnosti startTask.

commandLine?: string

Hodnota vlastnosti

string

containerSettings

Při zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) namapují do kontejneru, všechny proměnné prostředí úkolů se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru.

containerSettings?: TaskContainerSettings

Hodnota vlastnosti

TaskContainerSettings

environmentSettings

Seznam nastavení proměnných prostředí pro spouštěcí úlohu.

environmentSettings?: EnvironmentSetting[]

Hodnota vlastnosti

EnvironmentSetting[]

maxTaskRetryCount

Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakovaných pokusů. Služba Batch úkol jednou vyzkouší a až do tohoto limitu se může opakovat. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch úlohu opakovat nebude. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení. Výchozí hodnota je 0.

maxTaskRetryCount?: number

Hodnota vlastnosti

number

resourceFiles

Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku.

resourceFiles?: ResourceFile[]

Hodnota vlastnosti

ResourceFile[]

userIdentity

Pokud ho vynecháte, spustí se jako uživatel bez oprávnění správce, který je pro danou úlohu jedinečný.

userIdentity?: UserIdentity

Hodnota vlastnosti

UserIdentity

waitForSuccess

Pokud je hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje opakování spouštěcího úkolu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol ani po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje pro něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o chybách plánování. Pokud je hodnota false, služba Batch nebude čekat na dokončení spouštěcího úkolu. V takovém případě mohou být na výpočetním uzlu spuštěny další úkoly, zatímco spouštěcí úkol je stále spuštěný. a i když se spouštěcí úkol nezdaří, nové úkoly budou i nadále naplánovány na uzlu. Výchozí hodnota je true.

waitForSuccess?: boolean

Hodnota vlastnosti

boolean