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.
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>"
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"
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 true az 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 |
- Megtudhatja, hogyan használhat környezeti változókat a Batch használatával.
- További információ a Batch fájljairól és könyvtárairól
- További információ a többpéldányos feladatokról.