BatchJobReleaseTask interface
Úloha uvolnění úlohy, která se má spustit při dokončení úlohy na libovolném výpočetním uzlu, na kterém je úloha spuštěná. Úloha uvolnění úlohy se spustí, když úloha skončí, z důvodu jedné z následujících možností: Uživatel zavolá rozhraní API pro ukončení úlohy nebo rozhraní API úlohy delete, zatímco úloha je stále aktivní, dosáhne se maximálního časového omezení doby trvání úlohy a úloha je stále aktivní nebo úloha správce úloh je dokončena a úloha je nakonfigurována tak, aby se ukončila po dokončení správce úloh. Úloha uvolnění úlohy běží na každém uzlu, kde jsou spuštěné úkoly úlohy, a úloha přípravy úlohy byla spuštěna a dokončena. Pokud uzel znovu naimajete po spuštění úkolu přípravy úlohy a úloha skončí bez jakýchkoli dalších úkolů úlohy spuštěné na daném uzlu (a proto se úloha přípravy úlohy znovu nespustí), úloha uvolnění úlohy se na daném výpočetním uzlu nespustí. Pokud se uzel restartuje, zatímco úloha uvolnění úlohy je stále spuštěná, úloha uvolnění úlohy se spustí znovu při spuštění výpočetního uzlu. Úloha není označena jako dokončená, dokud se nedokončily všechny úkoly uvolnění úlohy. Úloha uvolnění úlohy se spouští na pozadí. Nezabývá plánovací slot; to znamená, že se nezapočítává do limitu taskSlotsPerNode zadaného ve fondu.
Vlastnosti
| command |
Příkazový řádek úlohy uvolnění úlohy. 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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| container |
Nastavení kontejneru, pod kterým běží úloha uvolnění úlohy. 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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům. |
| environment |
Seznam nastavení proměnných prostředí pro úlohu uvolnění úlohy. |
| id | Řetězec, který jednoznačně identifikuje úlohu uvolnění úlohy v rámci úlohy. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nezadáte, služba Batch přiřadí výchozí hodnotu jobrelease. Žádný jiný úkol v úloze nemůže mít stejné ID jako úloha uvolnění úlohy. Pokud se pokusíte odeslat úkol se stejným ID, služba Batch odmítne požadavek s kódem chyby TaskIdSameAsJobReleaseTask; Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409 (konflikt). |
| max |
Maximální uplynulý čas, po který může úloha uvolnění úlohy běžet na daném výpočetním uzlu měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí. Výchozí hodnota je 15 minut. Časový limit nesmí být delší než 15 minut. Pokud to uděláte, služba Batch ji odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). |
| 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. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu. |
| retention |
Minimální doba uchování adresáře úloh pro úlohu uvolnění úlohy na výpočetním uzlu. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah. Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní. |
| user |
Identita uživatele, pod kterou se spouští úloha uvolnění úlohy. Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úlohu jedinečný. |
Podrobnosti vlastnosti
commandLine
Příkazový řádek úlohy uvolnění úlohy. 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. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
commandLine: stringHodnota vlastnosti
string
containerSettings
Nastavení kontejneru, pod kterým běží úloha uvolnění úlohy. 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 v kontejneru se spustí příkazový řádek úkolu. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na hostitelském disku, což znamená, že rozhraní API souborů batch nebudou mít přístup k těmto souborům.
containerSettings?: BatchTaskContainerSettingsHodnota vlastnosti
environmentSettings
Seznam nastavení proměnných prostředí pro úlohu uvolnění úlohy.
environmentSettings?: EnvironmentSetting[]Hodnota vlastnosti
id
Řetězec, který jednoznačně identifikuje úlohu uvolnění úlohy v rámci úlohy. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nezadáte, služba Batch přiřadí výchozí hodnotu jobrelease. Žádný jiný úkol v úloze nemůže mít stejné ID jako úloha uvolnění úlohy. Pokud se pokusíte odeslat úkol se stejným ID, služba Batch odmítne požadavek s kódem chyby TaskIdSameAsJobReleaseTask; Pokud rozhraní REST API voláte přímo, stavový kód HTTP je 409 (konflikt).
id?: stringHodnota vlastnosti
string
maxWallClockTime
Maximální uplynulý čas, po který může úloha uvolnění úlohy běžet na daném výpočetním uzlu měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončí v časovém limitu, služba Batch ji ukončí. Výchozí hodnota je 15 minut. Časový limit nesmí být delší než 15 minut. Pokud to uděláte, služba Batch ji odmítne s chybou; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek).
maxWallClockTime?: stringHodnota vlastnosti
string
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. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu.
resourceFiles?: ResourceFile[]Hodnota vlastnosti
retentionTime
Minimální doba uchování adresáře úloh pro úlohu uvolnění úlohy na výpočetním uzlu. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah. Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní.
retentionTime?: stringHodnota vlastnosti
string
userIdentity
Identita uživatele, pod kterou se spouští úloha uvolnění úlohy. Pokud tento parametr vynecháte, úloha se spustí jako uživatel, který není správcem, který je pro úlohu jedinečný.
userIdentity?: UserIdentity