StartTask interface
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 bez odkladu ukončovat, pokud už bylo provedeno nastavení, které provádí. Je potřeba věnovat zvláštní pozornost tomu, abyste se vyhnuli spouštěcím úkolům, které vytvářejí odkládací proces nebo instalují nebo spouštějí služby z pracovního adresáře spouštěcích úloh, protože to službě Batch zabrání v opětovném spuštění spouštěcí úlohy.
Vlastnosti
| command |
Příkazový řádek se nespustí pod prostředím, 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í na 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 další vlastnosti startTask. |
| container |
Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru. |
| environment |
Seznam nastavení proměnných prostředí pro spouštěcí úlohu. |
| max |
Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení. Výchozí hodnota je 0 |
| resource |
Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. |
| user |
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný. |
| wait |
Pokud hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true. |
Podrobnosti vlastnosti
commandLine
Příkazový řádek se nespustí pod prostředím, 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í na 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 další vlastnosti startTask.
commandLine?: string
Hodnota vlastnosti
string
containerSettings
Po zadání se všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen adresářů Azure Batch na uzlu) mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úkolu se spustí v kontejneru.
containerSettings?: TaskContainerSettings
Hodnota vlastnosti
environmentSettings
Seznam nastavení proměnných prostředí pro spouštěcí úlohu.
environmentSettings?: EnvironmentSetting[]
Hodnota vlastnosti
maxTaskRetryCount
Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohu. 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
userIdentity
Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úkol jedinečný.
userIdentity?: UserIdentity
Hodnota vlastnosti
waitForSuccess
Pokud hodnota true a spouštěcí úkol selže na výpočetním uzlu, služba Batch opakuje spouštěcí úlohu až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úkol po všech opakováních úspěšně nedokončil, služba Batch označí výpočetní uzel jako nepoužitelný a neplánuje do něj úkoly. Tuto podmínku lze zjistit prostřednictvím stavu uzlu a podrobností o plánování chyb. Pokud je false, služba Batch nebude čekat na dokončení spouštěcí úlohy. V tomto případě můžou na výpočetním uzlu začít spouštět jiné úkoly, zatímco spouštěcí úkol je stále spuštěný; i v případě, že spouštěcí úkol selže, budou na uzlu i nadále naplánované nové úkoly. Výchozí hodnota je true.
waitForSuccess?: boolean
Hodnota vlastnosti
boolean