Dela via

Miljövariabler för Azure Batch-körning

Azure Batch-tjänsten anger följande miljövariabler på beräkningsnoder. Du kan referera till dessa miljövariabler i aktivitetskommandorader och i de program och skript som körs av kommandoraderna.

Mer information om hur du använder miljövariabler med Batch finns i Miljöinställningar för uppgifter.

Synlighet för miljövariabel

Dessa miljövariabler visas endast i kontexten för uppgiftsanvändaren, som är användarkontot på noden under vilken en uppgift körs. Du ser inte dessa variabler när du ansluter via fjärranslutning till en beräkningsnod via RDP (Remote Desktop Protocol) eller Secure Shell (SSH) och visar miljövariabler. Det beror på att användarkontot som används för fjärranslutning inte är detsamma som det konto som används av uppgiften.

Om du vill hämta det aktuella värdet för en miljövariabel startar du cmd.exe på en Windows-beräkningsnod eller /bin/sh på en Linux-nod:

cmd /c set <ENV_VARIABLE_NAME>

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

Kommandoradsexpansion av miljövariabler

Kommandoraderna som körs av processer på beräkningsnoder körs inte under en skalkommandotolk. Det innebär att dessa kommandorader inte kan använda gränssnittsfunktioner som miljövariabelexpansion (inklusive PATH). Om du vill använda sådana funktioner måste du anropa gränssnittet på kommandoraden. Starta till exempel cmd.exe på Windows-beräkningsnoder eller /bin/sh på Linux-noder:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Miljövariabler

Anmärkning

AZ_BATCH_AUTHENTICATION_TOKEN är inaktuell och går i pension den 30 september 2024. Mer information och alternativ implementering finns i meddelandet .

Variabelnamn Beskrivning Tillgänglighet Exempel
AZ_BATCH_ACCOUNT_NAME Namnet på batchkontot som aktiviteten tillhör. Alla uppgifter. mybatchkonto
AZ_BATCH_ACCOUNT_URL URL:en för Batch-kontot. Alla uppgifter. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Ett prefix för alla miljövariabler för apppaket. Om programversionen "FOO" "1" till exempel är installerad på en pool är miljövariabeln AZ_BATCH_APP_PACKAGE_FOO_1 (på Linux) eller AZ_BATCH_APP_PACKAGE_FOO#1 (i Windows). AZ_BATCH_APP_PACKAGE_FOO_1 pekar på platsen där paketet laddades ned (en mapp). När du använder standardversionen av apppaketet använder du miljövariabeln AZ_BATCH_APP_PACKAGE utan versionsnummer. Om du är på Linux och programpaketnamnet är "Agent-linux-x64" och versionen är "1.1.46.0", är miljönamnet faktiskt: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, med understreck och gemener. Mer information finns i Köra installerade program för mer information. Alla aktiviteter med ett associerat apppaket. Finns även för alla aktiviteter om själva noden har programpaket. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) eller AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN En autentiseringstoken som ger åtkomst till en begränsad uppsättning Batch-tjänståtgärder. Den här miljövariabeln finns bara om authenticationTokenSettings anges när uppgiften läggs till. Tokenvärdet används i Batch-API:erna som autentiseringsuppgifter för att skapa en Batch-klient, till exempel i .NET-API:et BatchClient.Open(). Token stöder inte privata nätverk. Alla uppgifter. OAuth2-åtkomsttoken
AZ_BATCH_CERTIFICATES_DIR En katalog i arbetskatalogen för uppgiften där certifikat lagras för Linux-beräkningsnoder. Den här miljövariabeln gäller inte för Windows-beräkningsnoder. Alla uppgifter. /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST Listan över noder som allokeras till en aktivitet med flera instanser i formatet nodeIP,nodeIP. Primär- och underaktiviteter för flera instanser. 10.0.0.4,10.0.0.5
[No improvements proposed if AZ_BATCH_IS_CURRENT_NODE_MASTER must remain unchanged for technical accuracy and context.] Anger om den aktuella noden är huvudnoden för en aktivitet med flera instanser. Möjliga värden är true och false. Primär- och underaktiviteter för flera instanser. true
AZ_BATCH_JOB_ID ID:t för jobbet som uppgiften tillhör. Alla aktiviteter utom startaktivitet. batchjob001
AZ_BATCH_JOB_PREP_DIR Den fullständiga sökvägen till jobbförberedelsekatalogen på noden. Alla aktiviteter utom startaktivitet och jobbförberedelseaktivitet. Endast tillgängligt om jobbet har konfigurerats med en jobbförberedelseuppgift. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR Den fullständiga sökvägen för arbetskatalogen för jobbförberedelseaktiviteten på noden. Alla aktiviteter utom startaktivitet och jobbförberedelseaktivitet. Endast tillgängligt om jobbet har konfigurerats med en jobbförberedelseuppgift. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE IP-adressen och porten för beräkningsnoden där den primära uppgiften för en aktivitet med flera instanser körs. Använd inte den port som anges här för MPI- eller NCCL-kommunikation – den är reserverad för Azure Batch-tjänsten. Använd variabeln MASTER_PORT i stället, antingen genom att ange den med ett värde som skickas via kommandoradsargumentet (port 6105 är ett bra standardval) eller genom att använda värdet AML-uppsättningar om det gör det. Primär- och underaktiviteter för flera instanser. 10.0.0.4:6000
AZ_BATCH_NODE_ID ID:t för noden som uppgiften har tilldelats till. Alla uppgifter. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Om trueär den aktuella noden en dedikerad nod. Om falseär det en Azure Spot-nod. Alla uppgifter. true
AZ_BATCH_NODE_LIST Listan över noder som allokeras till en aktivitet med flera instanser i formatet nodeIP;nodeIP. Primär- och underaktiviteter för flera instanser. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Den fullständiga sökvägen för filsystemets monteringsplats på nodnivå där alla monteringskataloger finns. Windows-filresurser använder en enhetsbeteckning, så för Windows är den monterade enheten en del av enheter och enheter. Alla uppgifter, inklusive startuppgift, kan nås av användaren, förutsatt att användaren är medveten om monteringsbehörigheterna för den monterade katalogen. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Den fullständiga sökvägen till rotkatalogen för alla Batch-kataloger på noden. Alla uppgifter. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Den fullständiga sökvägen till den delade katalogen på noden. Alla aktiviteter som körs på en nod har läs- och skrivåtkomst till den här katalogen. Processer som körs på andra noder har inte fjärråtkomst till denna katalog (det är inte en "delad" nätverkskatalog). Alla uppgifter. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Den fullständiga sökvägen till starttask-katalogen på noden. Alla uppgifter. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID ID:t för poolen som aktiviteten körs på. Alla uppgifter. batchpool001
AZ_BATCH_TASK_DIR Den fullständiga sökvägen till aktivitetskatalogen på noden. Den här katalogen innehåller stdout.txt och stderr.txt för uppgiften samt AZ_BATCH_TASK_WORKING_DIR. Alla uppgifter. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID ID för den aktuella aktiviteten. Alla aktiviteter utom startaktivitet. Uppgift001
AZ_BATCH_TASK_SHARED_DIR En katalogsökväg som är identisk för den primära aktiviteten och varje underavdelning för en aktivitet med flera instanser. Sökvägen finns på varje nod där aktiviteten för flera instanser körs och är läs-/skrivtillgänglig för de aktivitetskommandon som körs på noden (både samordningskommandot och programkommandot. Underaktiviteter eller en primär aktivitet som körs på andra noder har inte fjärråtkomst till den här katalogen (det är inte en "delad" nätverkskatalog). Primär- och underaktiviteter för flera instanser. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR Den fullständiga sökvägen till arbetskatalogen för uppgiften på noden. Den pågående arbetsuppgiften har läs- och skrivåtkomst till den här katalogen. Alla uppgifter. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES Det aktuella tröskelvärdet för diskutrymme vid vilket den virtuella datorn kommer att markeras som DiskFull. Alla uppgifter. 1 000 000
CCP_NODES Listan över noder och antalet kärnor per nod som allokeras till en aktivitet med flera instanser. Noder och kärnor visas i formatet numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., där antalet noder följs av en eller flera nod-IP-adresser och antalet kärnor för var och en.		 Primär- och underaktiviteter för flera instanser. 2 10.0.0.4 1 10.0.0.5 1

Viktigt!

Exakta värden för sökvägar för miljövariabler betraktas som implementeringsinformation och kan komma att ändras. Använd miljövariablerna som tillhandahålls av Batch i stället för att försöka konstruera råa sökvägsrepresentationer.

Följande tabell anger värdena för varje postfix för miljövariabelvärden efter AZ_BATCH_NODE_ROOT_DIR-värdet. Mer information finns i AZ_BATCH_NODE_ROOT_DIR .

Miljövariabelns namn Postfix för katalogen med miljövariabelvärden
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

Jobbkatalogerna skiljer sig mellan enkelgångsjobb och jobbscheman. I följande tabell anges värdena för jobbkatalogen i ett enkörarjobb och i jobbschemat.

Jobbtyp Postfix för jobbkatalogvärde efter AZ_BATCH_NODE_ROOT_DIR
Jobb workitems\{job name}\job-1
Jobbschema workitems\{job schedule name}\{job name}

I följande tabell anges värdena för varje miljövariabelvärde efter jobbkatalogen.

Miljövariabelns namn Miljövariabelns värde katalogsuffix efter jobbkatalog
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

Nästa steg