Share via

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

  • Cikk

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. Ez azért van, mert a távoli kapcsolat kialakításához használt felhasználói fiók nem egyezik a tevékenységhez használt fiókkal.

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 meg kell hívnia a rendszerhéjat a parancssorban. Indítás például cmd.exe Windows számítási csomópontokon vagy /bin/sh Linux-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 megszűnik, é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 Availability Example
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-címe. 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észletre, 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 authenticationToken Gépház a feladat hozzáadásakor van beállítva. A jogkivonat értékét a Batch API-k hitelesítő adatokként használják egy Batch-ügyfél létrehozásához, például a BatchClient.Open() .NET API-ban. A jogkivonat nem támogatja a privát hálózatkezelést. 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átumbannodeIP,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 fióknak az azonosítója, amelyhez a feladat 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. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation
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. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd
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 úgy, hogy a parancssori argumentumon keresztül átadott értékkel állítja be (a 6105-ös port az alapértelmezett választás), vagy ha igen, használja az AML-halmazokat. 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átumbannodeIP;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 Ubuntu-ban például a hely a következő: /mnt/batch/tasks/fsmounts
AZ_BATCH_NODE_ROOT_DIR A csomópont összes Batch-címtárának gyökérútvonala. Minden tevékenység. C:\user\tasks
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. C:\user\tasks\shared
AZ_BATCH_NODE_STARTUP_DIR A csomópont kezdő tevékenységkönyvtárának teljes elérési útja. Minden tevékenység. C:\user\tasks\startup
AZ_BATCH_POOL_ID Annak a készletnek azonosítója, amelyen a tevékenység fut. Minden tevékenység. batchpool001
AZ_BATCH_TASK_DIR A csomópont tevékenységkönyvtárának teljes elérési útja. Ez a könyvtár tartalmazza a stdout.txt feladat és stderr.txt a AZ_BATCH_TASK_WORKING_DIR. Minden tevékenység. C:\user\tasks\workitems\batchjob001\job-1\task001
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. task001
AZ_BATCH_TASK_SHARED_DIR Egy címtár elérési útja, amely azonos az elsődleges tevékenységhez és egy többpéldányos tevékenység minden altevékenységéhez. 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. C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask
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. C:\user\tasks\workitems\batchjob001\job-1\task001\wd
AZ_BATCH_TASK_REStandard kiadásRVED_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 formátuma 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

Következő lépések