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

  • Artikel

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 samma som det konto som används av aktiviteten.

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 uppgifter på beräkningsnoder körs inte under ett gränssnitt. 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

Kommentar

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

Variabelnamn Description Tillgänglighet Exempel
AZ_BATCH_ACCOUNT_NAME Namnet på batchkontot som aktiviteten tillhör. Alla uppgifter. mybatchaccount
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 i 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 authenticationToken Inställningar 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
AZ_BATCH_IS_CURRENT_NODE_MASTER 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 aktiviteten hör till. Alla aktiviteter utom startaktivitet. batchjob001
AZ_BATCH_JOB_PREP_DIR Den fullständiga sökvägen till arbetsförberedelseaktivitetskatalogen på noden. Alla aktiviteter utom startaktivitet och jobbförberedelseaktivitet. Endast tillgängligt om jobbet har konfigurerats med en jobbförberedelseaktivitet. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation
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örberedelseaktivitet. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd
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 monteringsenheten en del av enheter och enheter. Alla uppgifter, inklusive startaktivitet, har åtkomst till användaren, eftersom användaren är medveten om monteringsbehörigheterna för den monterade katalogen. I Ubuntu är till exempel platsen: /mnt/batch/tasks/fsmounts
AZ_BATCH_NODE_ROOT_DIR Den fullständiga sökvägen till roten för alla Batch-kataloger på noden. Alla uppgifter. C:\user\tasks
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. Uppgifter som körs på andra noder har inte fjärråtkomst till den här katalogen (det är inte en "delad" nätverkskatalog). Alla uppgifter. C:\user\tasks\shared
AZ_BATCH_NODE_STARTUP_DIR Den fullständiga sökvägen till startaktivitetskatalogen på noden. Alla uppgifter. C:\user\tasks\startup
AZ_BATCH_POOL_ID ID:t för poolen som aktiviteten körs i. 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 uppgiften och stderr.txt och AZ_BATCH_TASK_WORKING_DIR. Alla uppgifter. C:\user\tasks\workitems\batchjob001\job-1\task001
AZ_BATCH_TASK_ID ID:t för den aktuella aktiviteten. Alla aktiviteter utom startaktivitet. task001
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. C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask
AZ_BATCH_TASK_WORKING_DIR Den fullständiga sökvägen till arbetskatalogen för uppgiften på noden. Den uppgift som körs har läs- och skrivåtkomst till den här katalogen. Alla uppgifter. C:\user\tasks\workitems\batchjob001\job-1\task001\wd
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES Det aktuella tröskelvärdet för diskutrymme som den virtuella datorn ska 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

Nästa steg