Freigeben über

Azure Batch-Laufzeitumgebungsvariablen

Der Azure Batch-Dienst legt die folgenden Umgebungsvariablen auf Computeknoten fest. Sie können auf diese Umgebungsvariablen in Aufgabenbefehlszeilen und in den Programmen und Skripts verweisen, die von den Befehlszeilen ausgeführt werden.

Weitere Informationen zur Verwendung von Umgebungsvariablen mit Batch finden Sie unter "Umgebungseinstellungen für Aufgaben".

Sichtbarkeit von Umgebungsvariablen

Diese Umgebungsvariablen sind nur im Kontext des Aufgabenbenutzers sichtbar, bei dem es sich um das Benutzerkonto auf dem Knoten handelt, unter dem eine Aufgabe ausgeführt wird. Sie werden nicht angezeigt, wenn Sie über RDP (Remotedesktopprotokoll) oder SSH (Secure Shell) eine Remoteverbindung zum Serverknoten herstellen und die Umgebungsvariablen auflisten. Dies liegt daran, dass das Benutzerkonto, das für die Remoteverbindung verwendet wird, nicht mit dem Konto übereinstimmt, das von der Aufgabe verwendet wird.

Um den aktuellen Wert einer Umgebungsvariable abzurufen, starten Sie cmd.exe auf einem Windows-Computeknoten oder /bin/sh auf einem Linux-Knoten:

cmd /c set <ENV_VARIABLE_NAME>

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

Befehlszeilenerweiterung von Umgebungsvariablen

Die bei Aufgaben auf Rechenknoten ausgeführten Befehlszeilen werden nicht unter einer Shell ausgeführt. Dies bedeutet, dass diese Befehlszeilen Shell-Features wie die Umgebungsvariablen-Erweiterung (einschließlich der PATH) nicht nativ verwenden können. Um solche Features zu verwenden, müssen Sie die Shell in der Befehlszeile aufrufen. Starten Sie cmd.exe beispielsweise auf Windows-Computeknoten oder /bin/sh auf Linux-Knoten:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Umgebungsvariablen

Hinweis

AZ_BATCH_AUTHENTICATION_TOKEN ist veraltet und wird am 30. September 2024 eingestellt. Details und alternative Implementierung finden Sie in der Ankündigung .

Variablenname BESCHREIBUNG Verfügbarkeit Beispiel
AZ_BATCH_ACCOUNT_NAME Der Name des Batchkontos, zu dem die Aufgabe gehört. Alle Aufgaben. mybatchaccount
AZ_BATCH_ACCOUNT_URL Die URL des Batchkontos. Alle Aufgaben. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Ein Präfix aller App-Paketumgebungsvariablen. Wenn zum Beispiel die Anwendung "FOO" in Version "1" auf einem Pool installiert ist, lautet die Umgebungsvariable AZ_BATCH_APP_PACKAGE_FOO_1 (unter Linux) oder AZ_BATCH_APP_PACKAGE_FOO#1 (unter Windows). AZ_BATCH_APP_PACKAGE_FOO_1 verweist auf den Speicherort, an den das Paket heruntergeladen wurde (ein Ordner). Verwenden Sie bei Verwendung der Standardversion des App-Pakets die AZ_BATCH_APP_PACKAGE Umgebungsvariable ohne die Versionsnummern. Wenn unter Linux und der Name des Anwendungspakets "Agent-linux-x64" lautet und die Version "1.1.46.0" lautet, lautet der Umgebungsname tatsächlich: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0 unter Verwendung von Unterstrichen und Kleinschreibung. Weitere Informationen finden Sie unter Ausführen der installierten Anwendungen. Jede Aufgabe mit einem zugeordneten App-Paket. Auch für alle Aufgaben verfügbar, wenn der Knoten selbst Anwendungspakete enthält. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) oder AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Ein Authentifizierungstoken, das Zugriff auf einen begrenzten Satz von Batchdienstvorgängen gewährt. Diese Umgebungsvariable ist nur vorhanden, wenn die authenticationTokenSettings festgelegt werden, wenn die Aufgabe hinzugefügt wird. Der Tokenwert wird in den Batch-APIs als Anmeldeinformationen zum Erstellen eines Batchclients verwendet, z. B. in der BatchClient.Open() .NET-API. Das Token unterstützt keine privaten Netzwerke. Alle Aufgaben. OAuth2-Zugriffstoken
AZ_BATCH_CERTIFICATES_DIR Ein Verzeichnis im Arbeitsverzeichnis der Aufgabe , in dem Zertifikate für Linux-Computeknoten gespeichert werden. Diese Umgebungsvariable gilt nicht für Windows-Computeknoten. Alle Aufgaben. /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST Die Liste der Knoten, die einem Vorgang mit mehreren Instanzen im Format nodeIP,nodeIPzugeordnet sind. Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Gibt an, ob der aktuelle Knoten der Masterknoten für eine Aufgabe mit mehreren Instanzen ist. Mögliche Werte sind true und false. Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. true
AZ_BATCH_JOB_ID Die ID des Jobs, zu dem die Aufgabe gehört. Alle Aufgaben mit Ausnahme des Startaufgaben. batchjob001
AZ_BATCH_JOB_PREP_DIR Der vollständige Pfad des Aufgabenverzeichnisses für die Auftragsvorbereitung auf dem Knoten. Alle Aufgaben außer Startaufgabe und Auftragsvorbereitungsaufgabe. Nur verfügbar, wenn der Auftrag mit einem Auftragsvorbereitungsvorgang konfiguriert ist. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR Der vollständige Pfad des Aufgabenarbeitsverzeichnisses für die Auftragsvorbereitung auf dem Knoten. Alle Aufgaben außer Startaufgabe und Auftragsvorbereitungsaufgabe. Nur verfügbar, wenn der Auftrag mit einem Auftragsvorbereitungsvorgang konfiguriert ist. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE Die IP-Adresse und der Port des Computeknotens, auf dem die primäre Aufgabe einer Aufgabe mit mehreren Instanzen ausgeführt wird. Verwenden Sie den hier angegebenen Port nicht für die MPI- oder NCCL-Kommunikation – sie ist für den Azure Batch-Dienst reserviert. Verwenden Sie stattdessen die Variable MASTER_PORT, indem Sie sie entweder mit einem Wert festlegen, der über einen Befehlszeilenparameter übergeben wird (Port 6105 ist eine gute Standardoption), oder indem Sie den von AML festgelegten Wert verwenden, falls dieser gesetzt wird. Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. 10.0.0.4:6000
AZ_BATCH_NODE_ID Die ID des Knotens, dem die Aufgabe zugewiesen ist. Alle Aufgaben. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Wenn true, ist der aktuelle Knoten ein dedizierter Knoten. Wenn false, es sich um einen Azure Spot-Knoten handelt. Alle Aufgaben. true
AZ_BATCH_NODE_LIST Die Liste der Knoten, die einem Vorgang mit mehreren Instanzen im Format nodeIP;nodeIPzugeordnet sind. Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Der vollständige Pfad des Speicherorts für die Bereitstellung des Dateisystems auf Knotenebene, an dem sich alle Bereitstellungsverzeichnisse befinden. Windows-Dateifreigaben verwenden einen Laufwerkbuchstaben. Unter Windows ist das Bereitstellungslaufwerk daher Teil von Geräten und Laufwerken. Alle Aufgaben, einschließlich der Startaufgabe, haben Zugriff auf den Benutzer, da der Benutzer über die Bereitstellungsberechtigungen für das bereitgestellte Verzeichnis informiert ist. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Der vollständige Pfad zum Stamm aller Batch-Verzeichnisse auf dem Knoten. Alle Aufgaben. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Der vollständige Pfad des freigegebenen Verzeichnisses auf dem Knoten. Alle Aufgaben, die auf einem Knoten ausgeführt werden, haben Lese-/Schreibzugriff auf dieses Verzeichnis. Aufgaben, die auf anderen Knoten ausgeführt werden, haben keinen Remotezugriff auf dieses Verzeichnis (es handelt sich nicht um ein "freigegebenes" Netzwerkverzeichnis). Alle Aufgaben. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Der vollständige Pfad des Startaufgabenverzeichnisses auf dem Knoten. Alle Aufgaben. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID Die ID des Pools, auf dem die Aufgabe ausgeführt wird. Alle Aufgaben. batchpool001
AZ_BATCH_TASK_DIR Der vollständige Pfad des Aufgabenverzeichnisses auf dem Knoten. Dieses Verzeichnis enthält stdout.txt und stderr.txt für die Aufgabe und AZ_BATCH_TASK_WORKING_DIR. Alle Aufgaben. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID Die ID der aktuellen Aufgabe. Alle Aufgaben mit Ausnahme des Startaufgaben. Aufgabe001
AZ_BATCH_TASK_SHARED_DIR Ein Verzeichnispfad, der für die primäre Aufgabe und jeden Teilvorgang eines Vorgangs mit mehreren Instanzen identisch ist. Der Pfad ist auf jedem Knoten vorhanden, auf dem die Mehrinstanzen-Aufgabe ausgeführt wird, und hat Lese-/Schreibzugriff auf die Befehle der Aufgaben, die auf diesem Knoten laufen (sowohl der Koordinationsbefehl als auch der Anwendungsbefehl. Teilvorgänge oder eine primäre Aufgabe, die auf anderen Knoten ausgeführt wird, haben keinen Remotezugriff auf dieses Verzeichnis (es handelt sich nicht um ein "freigegebenes" Netzwerkverzeichnis). Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR Der vollständige Pfad des Aufgabenarbeitsverzeichnisses auf dem Knoten. Die derzeit ausgeführte Aufgabe verfügt über Lese-/Schreibzugriff auf dieses Verzeichnis. Alle Aufgaben. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES Der aktuelle Schwellenwert für den Speicherplatz, auf dem der virtuelle Computer als DiskFullgekennzeichnet wird. Alle Aufgaben. 1000000
CCP_NODES Die Liste der Knoten und die Anzahl der Kerne pro Knoten, die einer Aufgabe mit mehreren Instanzen zugeordnet sind. Knoten und Kerne werden im Format aufgelistet. numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., wobei auf die Anzahl der Knoten eine oder mehrere Knoten-IP-Adressen und die Anzahl der Kerne für jedes Knoten folgt.		 Primäre Aufgaben und Teilvorgänge mit mehreren Instanzen. 2 10.0.0.4 1 10.0.0.5 1

Von Bedeutung

Genaue Werte für Pfade für Umgebungsvariablen werden als Implementierungsdetails betrachtet und können geändert werden. Verwenden Sie die vom Batch bereitgestellten Umgebungsvariablen, anstatt zu versuchen, rohe Pfaddarstellungen zu erstellen.

In der folgenden Tabelle sind die Postfix-Werte jeder Umgebungsvariablen nach dem Wert von AZ_BATCH_NODE_ROOT_DIR spezifiziert. Weitere Informationen finden Sie unter AZ_BATCH_NODE_ROOT_DIR.

Name der Umgebungsvariablen Postfix des Umgebungsvariablen-Wertverzeichnisses
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

Die Auftragsverzeichnisse unterscheiden sich zwischen Einzelausführungsauftrag und Auftragszeitplan. In der folgenden Tabelle werden die Werte des Auftragsverzeichnisses im Einzellaufauftrag und Auftragszeitplan angegeben.

Auftragstyp Postfix des Auftragsverzeichniswerts nach AZ_BATCH_NODE_ROOT_DIR
Beruf workitems\{job name}\job-1
Auftragsplan workitems\{job schedule name}\{job name}

In der folgenden Tabelle werden die Werte der einzelnen Postfixs der Umgebungsvariablenwert nach dem Auftragsverzeichnis angegeben.

Name der Umgebungsvariablen Postfix des Umgebungsvariablen-Wertverzeichnisses nach dem Auftragsverzeichnis
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ächste Schritte