BatchTask interface

Csomag:

@azure/batch

A Batch újrapróbálkozza a feladatokat, ha egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem megfelelő csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a maxTaskRetryCount értékétől, és nem számítanak bele. Még ha a maxTaskRetryCount száma 0 is, belső újrapróbálkozhat egy helyreállítási művelet miatt. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a tevékenységeknek el kell viselnie a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata.

Tulajdonságok

affinityInfo	Egy helyi tipp, amelyet a Batch szolgáltatás használhat egy Compute Node kiválasztására, amelyen elindíthatja az új feladatot.
applicationPackageReferences	Egy lista azokról a csomagokról, amelyeket a Batch szolgáltatás telepít a Compute Node-ra a parancssor futtatása előtt. Az alkalmazáscsomagokat egy megosztott könyvtárba töltik le és telepítik, nem a Feladat munkakönyvtárba. Ezért, ha egy hivatkozott csomag már van a Node-on és naprakész, akkor nem töltik le újra; a Compute Node meglévő példányát használják. Ha egy hivatkozott csomagot nem lehet telepíteni, például mert a csomagot törölték vagy a letöltés sikertelen, akkor a feladat meghibásodik.
commandLine	A Feladat parancssora. Többpéldányos feladatoknál a parancssort elsődleges feladatként hajtják végre, miután az elsődleges feladat és minden alfeladat befejezte a koordinációs parancssort. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki akarod használni az ilyen funkciókat, hívd meg a shellet a parancssorban, például a "cmd /c MyCommand" Windows-ben vagy a "/bin/sh -c MyCommand" használatával Linuxban. Ha a parancssor fájlelérési utakra hivatkozik, akkor relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	A végrehajtási korlátok, amelyek erre a feladatra vonatkoznak.
containerSettings	A konténer, amely alatt a feladat fut. Ha a Feladatot futtató Pool ContainerConfiguration beállított, ezt is be kell állítani. Ha a Pool, amely ezt a feladatot futtatja, nincs containerConfiguration beállítással, akkor ezt nem szabad beállítani. Ha ezt megadják, az összes AZ_BATCH_NODE_ROOT_DIR alatti könyvtár (a csomóponton lévő Azure Batch könyvtár gyökere) rekurzívan a konténerbe kerül, az összes Feladatkörnyezet változót a konténerbe képezik, és a Feladat parancssort a konténerben futtatják. A konténerben AZ_BATCH_NODE_ROOT_DIR kívül előállított fájlok nem feltétlenül tükröződnek a hasztlemezre, ami azt jelenti, hogy a Batch fájl API-k nem férnek hozzá ezekhez a fájlokhoz.
creationTime	A Feladat létrehozásának ideje.
dependsOn	Azok a feladatok, amelyekre ez a feladat támaszkodik. Ezt a feladatot csak akkor ütemezik, ha minden feladat, amelyhez épül, sikeresen teljesített. Ha bármelyik feladat megbukik és kimeríti az újrapróbálkozási számát, ez a feladat soha nem lesz ütemezve.
displayName	A Feladat megjelenítési neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.
environmentSettings	A Feladat környezeti változóbeállításainak listája.
eTag	A feladat ETag-ja. Ez egy átlátszatlan sztring. Használhatod arra, hogy érzékeld, változott-e a feladat a kérések között. Különösen az ETag-ot átadhatod egy Feladat frissítésekor, hogy megadja, hogy a változtatások csak akkor lépjenek életbe, ha senki más nem módosította a feladatot az időben.
executionInfo	Információk a feladat végrehajtásáról.
exitConditions	Hogyan reagáljon a Batch szolgáltatásnak, amikor a Feladat befejeződik.
id	Egy láncszál, amely egyedien azonosítja a Feladatot a Feladaton belül. Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat.
lastModified	A Feladat utolsó módosított ideje.
multiInstanceSettings	Egy objektum, amely jelzi, hogy a Feladat többpéldányos feladat, és információkat tartalmaz a többpéldányos feladat futtatásáról.
nodeInfo	Információk a Számítási csomópontról, amelyen a feladat futott.
outputFiles	Egy lista azokról a fájlokról, amelyeket a Batch szolgáltatás feltölt a Compute Node-ról a parancssor futtatása után. Többpéldányos feladatoknál a fájlokat csak az a Compute Node-ból töltik fel, ahol az elsődleges feladat végrehajtódik.
previousState	A Feladat korábbi állapota. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van.
previousStateTransitionTime	Az az idő, amikor a Feladat korábbi állapotába került. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van.
requiredSlots	A feladatnak szükséges ütemezési helyek száma. Alapértéke 1. Egy feladatot csak akkor lehet beosztani egy számítási csomóponton, ha a csomópontnak elegendő szabad ütemezési helye van. Többpéldányos feladatokhoz ennek 1-nek kell lennie.
resourceFiles	Azon fájlok listája, amelyeket a Batch szolgáltatás a parancssor futtatása előtt letölt a számítási csomópontra. Többpéldányos feladatoknál az erőforrás fájlok csak arra a Compute Node-ra kerülnek le, ahol a fő feladatot teljesítik. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
state	A Feladat jelenlegi állapota.
stateTransitionTime	Az az idő, amikor a Feladat jelenlegi állapotába került.
taskStatistics	Erőforrás-felhasználási statisztikák a feladathoz.
url	A feladat URL-je.
userIdentity	Az a felhasználói azonosító, amely alatt a Feladat fut. Ha kihagyják, a feladat nem adminisztratív felhasználóként fut el, amely egyedi, a feladatra jellemző.

Tulajdonság adatai

affinityInfo

Egy helyi tipp, amelyet a Batch szolgáltatás használhat egy Compute Node kiválasztására, amelyen elindíthatja az új feladatot.

affinityInfo?: BatchAffinityInfo

Tulajdonság értéke

BatchAffinityInfo

applicationPackageReferences

Egy lista azokról a csomagokról, amelyeket a Batch szolgáltatás telepít a Compute Node-ra a parancssor futtatása előtt. Az alkalmazáscsomagokat egy megosztott könyvtárba töltik le és telepítik, nem a Feladat munkakönyvtárba. Ezért, ha egy hivatkozott csomag már van a Node-on és naprakész, akkor nem töltik le újra; a Compute Node meglévő példányát használják. Ha egy hivatkozott csomagot nem lehet telepíteni, például mert a csomagot törölték vagy a letöltés sikertelen, akkor a feladat meghibásodik.

applicationPackageReferences?: BatchApplicationPackageReference[]

Tulajdonság értéke

BatchApplicationPackageReference[]

commandLine

A Feladat parancssora. Többpéldányos feladatoknál a parancssort elsődleges feladatként hajtják végre, miután az elsődleges feladat és minden alfeladat befejezte a koordinációs parancssort. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki akarod használni az ilyen funkciókat, hívd meg a shellet a parancssorban, például a "cmd /c MyCommand" Windows-ben vagy a "/bin/sh -c MyCommand" használatával Linuxban. Ha a parancssor fájlelérési utakra hivatkozik, akkor relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

commandLine: string

Tulajdonság értéke

string

constraints

A végrehajtási korlátok, amelyek erre a feladatra vonatkoznak.

constraints?: BatchTaskConstraints

Tulajdonság értéke

BatchTaskConstraints

containerSettings

A konténer, amely alatt a feladat fut. Ha a Feladatot futtató Pool ContainerConfiguration beállított, ezt is be kell állítani. Ha a Pool, amely ezt a feladatot futtatja, nincs containerConfiguration beállítással, akkor ezt nem szabad beállítani. Ha ezt megadják, az összes AZ_BATCH_NODE_ROOT_DIR alatti könyvtár (a csomóponton lévő Azure Batch könyvtár gyökere) rekurzívan a konténerbe kerül, az összes Feladatkörnyezet változót a konténerbe képezik, és a Feladat parancssort a konténerben futtatják. A konténerben AZ_BATCH_NODE_ROOT_DIR kívül előállított fájlok nem feltétlenül tükröződnek a hasztlemezre, ami azt jelenti, hogy a Batch fájl API-k nem férnek hozzá ezekhez a fájlokhoz.

containerSettings?: BatchTaskContainerSettings

Tulajdonság értéke

BatchTaskContainerSettings

creationTime

A Feladat létrehozásának ideje.

creationTime: Date

Tulajdonság értéke

Date

dependsOn

Azok a feladatok, amelyekre ez a feladat támaszkodik. Ezt a feladatot csak akkor ütemezik, ha minden feladat, amelyhez épül, sikeresen teljesített. Ha bármelyik feladat megbukik és kimeríti az újrapróbálkozási számát, ez a feladat soha nem lesz ütemezve.

dependsOn?: BatchTaskDependencies

Tulajdonság értéke

BatchTaskDependencies

displayName

A Feladat megjelenítési neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.

displayName?: string

Tulajdonság értéke

string

environmentSettings

A Feladat környezeti változóbeállításainak listája.

environmentSettings?: EnvironmentSetting[]

Tulajdonság értéke

EnvironmentSetting[]

eTag

A feladat ETag-ja. Ez egy átlátszatlan sztring. Használhatod arra, hogy érzékeld, változott-e a feladat a kérések között. Különösen az ETag-ot átadhatod egy Feladat frissítésekor, hogy megadja, hogy a változtatások csak akkor lépjenek életbe, ha senki más nem módosította a feladatot az időben.

eTag: string

Tulajdonság értéke

string

executionInfo

Információk a feladat végrehajtásáról.

executionInfo?: BatchTaskExecutionInfo

Tulajdonság értéke

BatchTaskExecutionInfo

exitConditions

Hogyan reagáljon a Batch szolgáltatásnak, amikor a Feladat befejeződik.

exitConditions?: ExitConditions

Tulajdonság értéke

ExitConditions

id

Egy láncszál, amely egyedien azonosítja a Feladatot a Feladaton belül. Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat.

id: string

Tulajdonság értéke

string

lastModified

A Feladat utolsó módosított ideje.

lastModified: Date

Tulajdonság értéke

Date

multiInstanceSettings

Egy objektum, amely jelzi, hogy a Feladat többpéldányos feladat, és információkat tartalmaz a többpéldányos feladat futtatásáról.

multiInstanceSettings?: MultiInstanceSettings

Tulajdonság értéke

MultiInstanceSettings

nodeInfo

Információk a Számítási csomópontról, amelyen a feladat futott.

nodeInfo?: BatchNodeInfo

Tulajdonság értéke

BatchNodeInfo

outputFiles

Egy lista azokról a fájlokról, amelyeket a Batch szolgáltatás feltölt a Compute Node-ról a parancssor futtatása után. Többpéldányos feladatoknál a fájlokat csak az a Compute Node-ból töltik fel, ahol az elsődleges feladat végrehajtódik.

outputFiles?: OutputFile[]

Tulajdonság értéke

OutputFile[]

previousState

A Feladat korábbi állapota. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van.

previousState?: BatchTaskState

Tulajdonság értéke

BatchTaskState

previousStateTransitionTime

Az az idő, amikor a Feladat korábbi állapotába került. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van.

previousStateTransitionTime?: Date

Tulajdonság értéke

Date

requiredSlots

A feladatnak szükséges ütemezési helyek száma. Alapértéke 1. Egy feladatot csak akkor lehet beosztani egy számítási csomóponton, ha a csomópontnak elegendő szabad ütemezési helye van. Többpéldányos feladatokhoz ennek 1-nek kell lennie.

requiredSlots?: number

Tulajdonság értéke

number

resourceFiles

Azon fájlok listája, amelyeket a Batch szolgáltatás a parancssor futtatása előtt letölt a számítási csomópontra. Többpéldányos feladatoknál az erőforrás fájlok csak arra a Compute Node-ra kerülnek le, ahol a fő feladatot teljesítik. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.

resourceFiles?: ResourceFile[]

Tulajdonság értéke

ResourceFile[]

state

A Feladat jelenlegi állapota.

state: BatchTaskState

Tulajdonság értéke

BatchTaskState

stateTransitionTime

Az az idő, amikor a Feladat jelenlegi állapotába került.

stateTransitionTime: Date

Tulajdonság értéke

Date

taskStatistics

Erőforrás-felhasználási statisztikák a feladathoz.

taskStatistics?: BatchTaskStatistics

Tulajdonság értéke

BatchTaskStatistics

url

A feladat URL-je.

url: string

Tulajdonság értéke

string

userIdentity

Az a felhasználói azonosító, amely alatt a Feladat fut. Ha kihagyják, a feladat nem adminisztratív felhasználóként fut el, amely egyedi, a feladatra jellemző.

userIdentity?: UserIdentity

Tulajdonság értéke

UserIdentity