Delen via

Omgevingsvariabelen van Azure Batch Runtime

De Azure Batch-service stelt de volgende omgevingsvariabelen in op rekenknooppunten. U kunt naar deze omgevingsvariabelen verwijzen in taakopdrachtregels en in de programma's en scripts die worden uitgevoerd door de opdrachtregels.

Zie Omgevingsinstellingen voor taken voor meer informatie over het gebruik van omgevingsvariabelen met Batch.

Zichtbaarheid van omgevingsvariabelen

Deze omgevingsvariabelen zijn alleen zichtbaar in de context van de taakgebruiker. Dit is het gebruikersaccount op het knooppunt waaronder een taak wordt uitgevoerd. U ziet deze variabelen niet wanneer u extern verbinding maakt met een rekenknooppunt via Remote Desktop Protocol (RDP) of Secure Shell (SSH) en omgevingsvariabelen weergeeft. Dit komt doordat het gebruikersaccount dat wordt gebruikt voor externe verbinding niet hetzelfde is als het account dat door de taak wordt gebruikt.

Als u de huidige waarde van een omgevingsvariabele wilt ophalen, start u cmd.exe op een Windows-rekenknooppunt of /bin/sh op een Linux-knooppunt:

cmd /c set <ENV_VARIABLE_NAME>

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

Opdrachtregeluitbreiding van omgevingsvariabelen

De opdrachtregels die door taken op rekenknooppunten worden uitgevoerd, worden niet uitgevoerd onder een shell. Dit betekent dat deze opdrachtregels geen systeemeigen shellfuncties kunnen gebruiken, zoals uitbreiding van omgevingsvariabelen (inclusief de PATH). Als u dergelijke functies wilt gebruiken, moet u de shell aanroepen op de opdrachtregel. Start cmd.exe bijvoorbeeld op Windows-rekenknooppunten of /bin/sh op Linux-knooppunten:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Omgevingsvariabelen

Opmerking

AZ_BATCH_AUTHENTICATION_TOKEN wordt afgeschaft en wordt buiten gebruik gesteld op 30 september 2024. Zie de aankondiging voor details en alternatieve implementatie.

Naam van de variabele Beschrijving Beschikbaarheid Voorbeeld
AZ_BATCH_ACCOUNT_NAME De naam van het Batch-account waartoe de taak behoort. Alle taken. mijnbatchaccount
AZ_BATCH_ACCOUNT_URL De URL van het Batch-account. Alle taken. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Een voorvoegsel van alle omgevingsvariabelen van het app-pakket. Als de toepassing 'FOO' versie 1 bijvoorbeeld is geïnstalleerd op een pool, wordt de omgevingsvariabele AZ_BATCH_APP_PACKAGE_FOO_1 (op Linux) of AZ_BATCH_APP_PACKAGE_FOO#1 (in Windows). AZ_BATCH_APP_PACKAGE_FOO_1 verwijst naar de locatie waar het pakket is gedownload (een map). Wanneer u de standaardversie van het app-pakket gebruikt, gebruikt u de omgevingsvariabele AZ_BATCH_APP_PACKAGE zonder de versienummers. Als in Linux en de naam van het toepassingspakket 'Agent-linux-x64' is en de versie 1.1.46.0 is, is de omgevingsnaam eigenlijk: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, met onderstrepingstekens en kleine letters. Zie De geïnstalleerde toepassingen uitvoeren voor meer informatie. Elke taak met een gekoppeld app-pakket. Ook beschikbaar voor alle taken als het knooppunt zelf toepassingspakketten heeft. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) of AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Een verificatietoken dat toegang verleent tot een beperkte set Batch-servicebewerkingen. Deze omgevingsvariabele is alleen aanwezig als de authenticationTokenSettings worden ingesteld wanneer de taak wordt toegevoegd. De tokenwaarde wordt gebruikt in de Batch-API's als referenties voor het maken van een Batch-client, zoals in de .NET API BatchClient.Open(). Het token biedt geen ondersteuning voor privénetwerken. Alle taken. OAuth2-toegangstoken
AZ_BATCH_CERTIFICATES_DIR Een map in de werkmap van de taak waarin certificaten worden opgeslagen voor Linux-rekenknooppunten. Deze omgevingsvariabele is niet van toepassing op Windows-rekenknooppunten. Alle taken. /mnt/batch/taken/werkitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST De lijst met knooppunten die zijn toegewezen aan een taak met meerdere exemplaren in het formaat nodeIP,nodeIP. Primaire taken en subtaken met meervoudige instantie. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_HUIDIGE_NODE_MASTER Hiermee geeft u op of het huidige knooppunt het hoofdknooppunt is voor een taak met meerdere exemplaren. Mogelijke waarden zijn true en false. Primaire taken en subtaken met meervoudige instantie. true
AZ_BATCH_JOB_ID De id van de taak waartoe de taak behoort. Alle taken behalve begintaak. batchjob001 zei:
AZ_BATCH_JOB_PREP_DIR Het volledige pad van de taakmap voor taakvoorbereiding op het knooppunt. Alle taken behalve begintaak en taakvoorbereidingstaak. Alleen beschikbaar als de taak is geconfigureerd met een taakvoorbereidingstaak. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR Het volledige pad van de werkmap van de taakvoorbereidingstaak op het knooppunt. Alle taken behalve begintaak en taakvoorbereidingstaak. Alleen beschikbaar als de taak is geconfigureerd met een taakvoorbereidingstaak. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE Het IP-adres en de poort van het rekenknooppunt waarop de primaire taak van een taak met meerdere exemplaren wordt uitgevoerd. Gebruik de poort die hier is opgegeven voor MPI- of NCCL-communicatie niet. Deze is gereserveerd voor de Azure Batch-service. Gebruik in plaats daarvan de variabele MASTER_PORT door deze in te stellen met een waarde die wordt doorgegeven via het opdrachtregelargument (poort 6105 is een goede standaardoptie) of door de waarde AML-sets te gebruiken als dit het geval is. Primaire taken en subtaken met meervoudige instantie. 10.0.0.4:6000
AZ_BATCH_NODE_ID De id van het knooppunt waaraan de taak is toegewezen. Alle taken. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Als true, is het huidige knooppunt een toegewijd knooppunt. Als falsehet een Azure Spot-knooppunt is. Alle taken. true
AZ_BATCH_NODE_LIST De lijst met knooppunten die zijn toegewezen aan een taak met meerdere exemplaren in het formaat nodeIP;nodeIP. Primaire taken en subtaken met meervoudige instantie. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Het volledige pad van de koppellocatie van het bestandssysteem op knooppuntniveau waar alle koppelmappen zich bevinden. Windows-bestandsshares gebruiken een stationsletter, dus voor Windows is de schijfkoppeling een onderdeel van apparaten en stations. Alle taken, waaronder de begintaak, hebben toegang tot de gebruiker, aangezien de gebruiker op de hoogte is van de koppelingsmachtigingen voor de gekoppelde map. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Het volledige pad van de root van alle Batch-mappen op het knooppunt. Alle taken. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Het volledige pad van de gedeelde map op het knooppunt. Alle taken die op een knooppunt worden uitgevoerd, hebben lees-/schrijftoegang tot deze map. Taken die worden uitgevoerd op andere knooppunten hebben geen externe toegang tot deze map (het is geen 'gedeelde' netwerkmap). Alle taken. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Het volledige pad van de starttaakdirectory op het knooppunt. Alle taken. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID De id van de pool waarop de taak wordt uitgevoerd. Alle taken. Batchpool001 zei:
AZ_BATCH_TASK_DIR Het volledige pad van de taakmap op het knooppunt. Deze directory bevat de stdout.txt en stderr.txt voor de taak en de AZ_BATCH_TASK_WORKING_DIR. Alle taken. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID De ID van de huidige taak. Alle taken behalve begintaak. taak001
AZ_BATCH_TASK_SHARED_DIR Een mappad dat identiek is voor de primaire taak en elke subtaak van een taak met meerdere exemplaren. Het pad bestaat op elk knooppunt waarop de taak met meerdere exemplaren wordt uitgevoerd en is toegankelijk voor de taakopdrachten die op dat knooppunt worden uitgevoerd (zowel de coördinatieopdracht als de toepassingsopdracht. Subtaken of een primaire taak die wordt uitgevoerd op andere knooppunten hebben geen externe toegang tot deze map (dit is geen gedeelde netwerkmap). Primaire taken en subtaken met meervoudige instantie. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR Het volledige pad van de taak werkmap op het knooppunt. De taak die momenteel wordt uitgevoerd, heeft lees-/schrijftoegang tot deze map. Alle taken. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES De huidige drempelwaarde voor schijfruimte waarop de virtuele machine wordt gemarkeerd als DiskFull. Alle taken. 1000000
CCP_NODES De lijst met knooppunten en het aantal kernen per knooppunt dat is toegewezen aan een taak met meerdere exemplaren. Knooppunten en kernen worden vermeld in de indeling numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., waarbij het aantal knooppunten wordt gevolgd door een of meer IP-adressen van knooppunten en het aantal kernen voor elk knooppunt.		 Primaire taken en subtaken met meervoudige instantie. 2 10.0.0.4 1 10.0.0.5 1

Belangrijk

Exacte waarden voor paden voor omgevingsvariabelen worden beschouwd als implementatiedetails en kunnen worden gewijzigd. Gebruik de door Batch geleverde omgevingsvariabelen in plaats van onbewerkte padweergaven te maken.

In de volgende tabel worden de waarden opgegeven van elke waarde van de omgevingsvariabele na de AZ_BATCH_NODE_ROOT_DIR-waarde. Zie AZ_BATCH_NODE_ROOT_DIR voor meer informatie.

Naam van omgevingsvariabele Adreslijst voor omgevingsvariabelewaarde
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

De taakmappen verschillen tussen taakplanning voor één uitvoering en taakplanning. In de volgende tabel worden de waarden van de jobdirectory opgegeven in een eenmalige taak en taakschema.

Taaktype Postfix voor taakmapwaarde na AZ_BATCH_NODE_ROOT_DIR
Functie workitems\{job name}\job-1
Taakplanning workitems\{job schedule name}\{job name}

In de volgende tabel worden de postfixwaarden van elke omgevingsvariabele na de taakmap opgegeven.

Naam van omgevingsvariabele Postfix voor waardemap van omgevingsvariabele na taakmap
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

Volgende stappen

  • Last updated on