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á řádka úkolu Job Release. 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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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 Job Release Task běží. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup. |
| environment |
Seznam nastavení proměnných prostředí pro úkol Job Release. |
| id | Řetězec, který jednoznačně identifikuje úkol Job Release v rámci Job. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítek a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nespecifikujete, služba Batch přiřadí výchozí hodnotu 'jobrelease'. Žádný jiný úkol v práci nemůže mít stejné ID jako úkol uvolnění úkolu. Pokud se pokusíte odeslat úkol se stejným ID, dávková služba žádost odmítne s chybovým kódem TaskIdSameAsJobReleaseTask; pokud voláte přímo REST API, HTTP stavový kód je 409 (Konflikt). |
| max |
Maximální doba, po kterou může úkol Job Release Task na daném Compute Node běžet, měřený od okamžiku spuštění úkolu. Pokud úkol není dokončen v časovém limitu, dávková služba jej ukončí. Výchozí hodnota je 15 minut. Nesmíte specifikovat timeout delší než 15 minut. Pokud ano, služba Batch ji zamítne s chybou; pokud voláte přímo REST API, HTTP stavový kód je 400 (Špatný požadavek). Doba trvání je specifikována ve formátu ISO 8601. |
| 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 pro uchování adresáře úloh pro úkol uvolnění úlohy na výpočetním uzlu. Po uplynutí této doby může služba Batch složku úkolů smazat a veškerý jeho obsah. Výchozí je 7 dní, tj. adresář úloh bude ponechán po dobu 7 dní, pokud není Compute Node odstraněn nebo Job smazán. Doba trvání je specifikována ve formátu ISO 8601. |
| user |
Uživatelská identita, pod kterou Job Release Task běží. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol. |
Podrobnosti vlastnosti
commandLine
Příkazová řádka úkolu Job Release. 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 využít takové funkce, měli byste shell spustit v příkazové řádku, například pomocí "cmd /c MyCommand" v 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 Job Release Task běží. Když je toto specifikováno, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) jsou namapovány do kontejneru, všechny proměnné prostředí úkolu jsou namapovány do kontejneru a příkazový řádek úkolu se vykoná v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR nemusí být zobrazeny na hostitelském disku, což znamená, že dávková API souborů k těmto souborům nebudou mít přístup.
containerSettings?: BatchTaskContainerSettingsHodnota vlastnosti
environmentSettings
Seznam nastavení proměnných prostředí pro úkol Job Release.
environmentSettings?: EnvironmentSetting[]Hodnota vlastnosti
id
Řetězec, který jednoznačně identifikuje úkol Job Release v rámci Job. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítek a nesmí obsahovat více než 64 znaků. Pokud tuto vlastnost nespecifikujete, služba Batch přiřadí výchozí hodnotu 'jobrelease'. Žádný jiný úkol v práci nemůže mít stejné ID jako úkol uvolnění úkolu. Pokud se pokusíte odeslat úkol se stejným ID, dávková služba žádost odmítne s chybovým kódem TaskIdSameAsJobReleaseTask; pokud voláte přímo REST API, HTTP stavový kód je 409 (Konflikt).
id?: stringHodnota vlastnosti
string
maxWallClockTime
Maximální doba, po kterou může úkol Job Release Task na daném Compute Node běžet, měřený od okamžiku spuštění úkolu. Pokud úkol není dokončen v časovém limitu, dávková služba jej ukončí. Výchozí hodnota je 15 minut. Nesmíte specifikovat timeout delší než 15 minut. Pokud ano, služba Batch ji zamítne s chybou; pokud voláte přímo REST API, HTTP stavový kód je 400 (Špatný požadavek). Doba trvání je specifikována ve formátu ISO 8601.
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 pro uchování adresáře úloh pro úkol uvolnění úlohy na výpočetním uzlu. Po uplynutí této doby může služba Batch složku úkolů smazat a veškerý jeho obsah. Výchozí je 7 dní, tj. adresář úloh bude ponechán po dobu 7 dní, pokud není Compute Node odstraněn nebo Job smazán. Doba trvání je specifikována ve formátu ISO 8601.
retentionTime?: stringHodnota vlastnosti
string
userIdentity
Uživatelská identita, pod kterou Job Release Task běží. Pokud je vynechán, Úkol běží jako neadministrátorský uživatel unikátní pro daný úkol.
userIdentity?: UserIdentity