Azure Batch futtatókörnyezet környezeti változói

Az Azure Batch szolgáltatás a következő környezeti változókat állítja be a számítási csomópontokon. Ezekre a környezeti változókra a feladat parancssoraiban, valamint a parancssorok által futtatott programokban és szkriptekben hivatkozhat.

A környezeti változók Batch-lel való használatával kapcsolatos további információkért lásd a tevékenységek környezeti beállításait.

Környezeti változó láthatósága

Ezek a környezeti változók csak a tevékenységfelhasználó környezetében láthatók, amely azon a csomóponton található felhasználói fiók, amely alatt a tevékenység végrehajtása történik. Ezeket a változókat nem fogja látni, ha távoli kapcsolattal csatlakozik egy számítási csomóponthoz távoli asztali protokollon (RDP) vagy Secure Shellen (SSH) keresztül, és felsorolja a környezeti változókat. Ennek az az oka, hogy a távoli kapcsolathoz használt felhasználói fiók nem ugyanaz, mint a feladat által használt fiók.

Egy környezeti változó aktuális értékének lekéréséhez indítsa el cmd.exe egy Windows számítási csomóponton vagy /bin/sh egy Linux-csomóponton:

cmd /c set <ENV_VARIABLE_NAME>

/bin/sh -c "printenv <ENV_VARIABLE_NAME>"

Környezeti változók parancssori bővítése

A számítási csomópontokon a feladatok által végrehajtott parancssorok nem rendszerhéj alatt futnak. Ez azt jelenti, hogy ezek a parancssorok natív módon nem használhatják a rendszerhéj olyan funkcióit, mint például a környezeti változók bővítése (beleértve a PATH). Az ilyen funkciók használatához el kell indítania a rendszerhéjat a parancssorban. Indítsa például a cmd.exe Windows számítási csomópontokon vagy a /bin/sh Linux számítási csomópontokon:

cmd /c MyTaskApplication.exe %MY_ENV_VAR% /bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Környezeti változók

Megjegyzés:

AZ_BATCH_AUTHENTICATION_TOKEN elavult, és 2024. szeptember 30-án megszűnik. Részletekért és alternatív megvalósításért tekintse meg a közleményt .

Változó neve Leírás Elérhetőség példa
AZ_BATCH_ACCOUNT_NAME Annak a Batch-fióknak a neve, amelyhez a tevékenység tartozik. Minden tevékenység. mybatchaccount
AZ_BATCH_ACCOUNT_URL A Batch-fiók URL-je. Minden tevékenység. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Az alkalmazáscsomag környezeti változóinak előtagja. Ha például az "FOO" alkalmazás "1" verziója telepítve van egy készletbe, a környezeti változó AZ_BATCH_APP_PACKAGE_FOO_1 (Linuxon) vagy AZ_BATCH_APP_PACKAGE_FOO#1 (Windows rendszeren). AZ_BATCH_APP_PACKAGE_FOO_1 a csomag letöltési helyére mutat (egy mappára). Az alkalmazáscsomag alapértelmezett verziójának használatakor használja a AZ_BATCH_APP_PACKAGE környezeti változót a verziószámok nélkül. Ha Linuxon az alkalmazáscsomag neve "Agent-linux-x64", a verzió pedig "1.1.46.0", akkor a környezet neve valójában: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, aláhúzásjelek és kisbetűk használatával. További információ: A telepített alkalmazások végrehajtása további részletekért. Bármely, társított alkalmazáscsomaggal rendelkező feladat. Akkor is elérhető minden tevékenységhez, ha maga a csomópont alkalmazáscsomagokkal rendelkezik. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) vagy AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Egy hitelesítési jogkivonat, amely korlátozott számú Batch-szolgáltatásművelethez biztosít hozzáférést. Ez a környezeti változó csak akkor jelenik meg, ha az authenticationTokenSettings beállítás a feladat hozzáadásakor van beállítva. A token értékét a Batch API-kban hitelesítő adatként használják a Batch-ügyfél létrehozásához. Az Azure.Compute.Batch esetében adja át a tokent egy egyéni TokenCredential használatával a BatchClient(Uri, TokenCredential) konstruktornak. A jogkivonat nem támogatja a privát hálózatot. Minden tevékenység. OAuth2 hozzáférési jogkivonat
AZ_BATCH_CERTIFICATES_DIR A feladat munkakönyvtárában található könyvtár, amelyben a linuxos számítási csomópontok tanúsítványai vannak tárolva. Ez a környezeti változó nem vonatkozik a Windows számítási csomópontokra. Minden tevékenység. /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST A többpéldányos feladathoz lefoglalt csomópontok listája a formátumban nodeIP,nodeIP. Többpéldányos elsődleges és altevékenységek. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Megadja, hogy az aktuális csomópont-e egy többpéldányos tevékenység fő csomópontja. A lehetséges értékek a következők: true és false. Többpéldányos elsődleges és altevékenységek. true
AZ_BATCH_JOB_ID Annak a feladatnak az azonosítója, amelyhez a tevékenység tartozik. Az indítási tevékenység kivételével minden tevékenység. batchjob001
AZ_BATCH_JOB_PREP_DIR A feladat-előkészítési feladatkönyvtár teljes elérési útja a csomóponton. Az indítási és a feladat-előkészítési tevékenység kivételével minden tevékenység. Csak akkor érhető el, ha a feladat feladat-előkészítési feladattal van konfigurálva. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR A feladat-előkészítési feladat munkakönyvtárának teljes elérési útja a csomóponton. Az indítási és a feladat-előkészítési tevékenység kivételével minden tevékenység. Csak akkor érhető el, ha a feladat feladat-előkészítési feladattal van konfigurálva. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE Annak a számítási csomópontnak az IP-címe és portja, amelyen egy többpéldányos tevékenység elsődleges feladata fut. Ne használja az itt megadott portot MPI- vagy NCCL-kommunikációhoz – az Azure Batch szolgáltatás számára van fenntartva. Használja inkább a MASTER_PORT változót, állítsa be a parancssori argumentumon keresztül kapott értékre (6105-ös port jó alapértelmezett választás), vagy ha az AML beállítja, használja azt az értéket. Többpéldányos elsődleges és altevékenységek. 10.0.0.4:6000
AZ_BATCH_NODE_ID Annak a csomópontnak az azonosítója, amelyhez a tevékenység hozzá van rendelve. Minden tevékenység. tvm-1219235766_3-20160919t172711z
AZ_BATCH_NODE_IS_DEDICATED Ha trueaz aktuális csomópont dedikált csomópont. Ha false, akkor ez egy Azure Spot-csomópont. Minden tevékenység. true
AZ_BATCH_NODE_LIST A többpéldányos feladathoz lefoglalt csomópontok listája a formátumban nodeIP;nodeIP. Többpéldányos elsődleges és altevékenységek. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR A csomópontszintű fájlrendszer csatlakoztatási helyének teljes elérési útja, ahol az összes csatlakoztatási könyvtár található. A Windows-fájlmegosztások meghajtóbetűjelet használnak, így Windows esetén a csatlakoztatási meghajtó az eszközök és meghajtók része. Az indítási feladatot is beleértve minden tevékenység rendelkezik hozzáféréssel a felhasználóhoz, mivel a felhasználó tisztában van a csatlakoztatott címtár csatlakoztatási engedélyével. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR A csomópont összes Batch-címtárának gyökérútvonala. Minden tevékenység. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR A megosztott könyvtár teljes elérési útja a csomóponton. A csomóponton végrehajtott összes tevékenység olvasási/írási hozzáféréssel rendelkezik ehhez a könyvtárhoz. A más csomópontokon végrehajtott feladatok nem rendelkeznek táveléréssel ehhez a könyvtárhoz (ez nem "megosztott" hálózati könyvtár). Minden tevékenység. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR A csomópont kezdőfeladat könyvtárának teljes elérési útja. Minden tevékenység. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID Annak a készletnek az azonosítója, amelyen a feladat fut. Minden tevékenység. batchpool001
AZ_BATCH_TASK_DIR A feladattár teljes elérési útja a csomóponton. Ez a könyvtár tartalmazza a stdout.txt és a stderr.txt elemeket a feladathoz, valamint az AZ_BATCH_TASK_WORKING_DIR-t. Minden tevékenység. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID Az aktuális tevékenység azonosítója. Az indítási tevékenység kivételével minden tevékenység. feladat001
AZ_BATCH_TASK_SHARED_DIR Egy címtár elérési útja, amely azonos az elsődleges feladathoz és egy többpéldányos feladat minden alfeladatához. Az elérési út minden csomóponton megtalálható, amelyen a többpéldányos feladat fut, és az adott csomóponton futó feladatparancsok (mind a koordinációs parancs , mind az alkalmazásparancs) számára elérhető. Az altevékenységek vagy a más csomópontokon végrehajtott elsődleges feladat nem rendelkezik táveléréssel ehhez a könyvtárhoz (ez nem "megosztott" hálózati könyvtár). Többpéldányos elsődleges és altevékenységek. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR A feladat munkakönyvtárának teljes elérési útja a csomóponton. A jelenleg futó feladat olvasási/írási hozzáféréssel rendelkezik ehhez a könyvtárhoz. Minden tevékenység. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES A lemezterület jelenlegi küszöbértéke, amelyen a virtuális gép meg lesz jelölve DiskFull. Minden tevékenység. 1 000 000
CCP_NODES A csomópontok listája és a csomópontonkénti magok száma, amelyek egy többpéldányos feladathoz vannak lefoglalva. A csomópontok és magok listázva vannak a formátumban numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., ahol a csomópontok számát egy vagy több csomóponti IP-cím és az egyes csomópontok magjainak száma követi.		 Többpéldányos elsődleges és altevékenységek. 2 10.0.0.4 1 10.0.0.5 1

Fontos

A környezeti változók elérési útjának pontos értékei implementálási részleteknek minősülnek, és változhatnak. Használja a Batch által biztosított környezeti változókat ahelyett, hogy nyers elérésiút-reprezentációkat próbál meg létrehozni.

Az alábbi táblázat az egyes környezeti változók utótagjainak értékeit határozza meg a AZ_BATCH_NODE_ROOT_DIR érték után. További információt a AZ_BATCH_NODE_ROOT_DIR talál.

Környezeti változó neve Környezeti változó érték könyvtárának postfixje
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

A feladatkönyvtárak különböznek az egyfuttatásos feladat és a feladatütemezés között. Az alábbi táblázat a feladatkönyvtár értékeit határozza meg az egyszeri futtatású feladatok és a feladatok ütemezésében.

Feladat típusa Feladatkönyvtár értékének utótagja AZ_BATCH_NODE_ROOT_DIR után
Foglalkozás workitems\{job name}\job-1
Feladatütemezés workitems\{job schedule name}\{job name}

Az alábbi táblázat az egyes környezeti változók utótagjainak értékét adja meg a feladatkönyvtár után.

Környezeti változó neve Környezeti változó érték könyvtárának postfix utótagja a feladatkönyvtár után
AZ_BATCH_TASK_WORKING_DIR {task name}\wd
AZ_BATCH_TASK_DIR {task name}
AZ_BATCH_TASK_SHARED_DIR {task name}
AZ_BATCH_JOB_PREP_DIR {job prepration task name}
AZ_BATCH_JOB_PREP_WORKING_DIR {job prepration task name}\wd

Következő lépések

  • Last updated on