Zmienne środowiskowe środowiska uruchomieniowego usługi Azure Batch

  • Artykuł

Usługa Azure Batch ustawia następujące zmienne środowiskowe w węzłach obliczeniowych. Można odwoływać się do tych zmiennych środowiskowych w wierszach poleceń zadań oraz w programach i skryptach uruchamianych za pomocą wierszy polecenia.

Aby uzyskać więcej informacji na temat używania zmiennych środowiskowych w usłudze Batch, zobacz Ustawienia środowiska dla zadań podrzędnych.

Widoczność zmiennej środowiskowej

Te zmienne środowiskowe są widoczne tylko w kontekście użytkownika zadania, czyli konta użytkownika w węźle, w którym jest wykonywane zadanie. Te zmienne nie będą widoczne podczas nawiązywania połączenia zdalnego z węzłem obliczeniowym za pośrednictwem protokołu RDP (Remote Desktop Protocol) ani protokołu Secure Shell (SSH) i wyświetlania zmiennych środowiskowych. Dzieje się tak dlatego, że konto użytkownika, używane na potrzeby połączenia zdalnego jest inne niż konto używane przez zadanie podrzędne.

Aby uzyskać bieżącą wartość zmiennej środowiskowej, uruchom polecenie cmd.exe w węźle obliczeniowym systemu Windows lub /bin/sh w węźle systemu Linux:

cmd /c set <ENV_VARIABLE_NAME>

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

Rozszerzanie wiersza polecenia zmiennych środowiskowych

Wiersze polecenia wykonywane przez zadania w węzłach obliczeniowych nie są uruchamiane w powłoce. Oznacza to, że te wiersze poleceń nie mogą natywnie używać funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej (w tym PATH). Aby użyć takich funkcji, należy wywołać powłokę w wierszu polecenia. Na przykład uruchom polecenie cmd.exe w węzłach obliczeniowych systemu Windows lub /bin/sh w węzłach systemu Linux:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Zmienne środowiskowe

Uwaga

AZ_BATCH_AUTHENTICATION_TOKEN jest przestarzały i zostanie wycofany 30 września 2024 r. Zobacz ogłoszenie, aby uzyskać szczegółowe informacje i alternatywną implementację.

Nazwa zmiennej opis Dostępność Przykład
AZ_BATCH_ACCOUNT_NAME Nazwa konta usługi Batch, do którego należy zadanie. Wszystkie zadania. mojekontobatch
AZ_BATCH_ACCOUNT_URL Adres URL konta usługi Batch. Wszystkie zadania. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Prefiks wszystkich zmiennych środowiskowych pakietu aplikacji. Jeśli na przykład aplikacja "FOO" w wersji "1" jest zainstalowana w puli, zmienna środowiskowa jest AZ_BATCH_APP_PACKAGE_FOO_1 (w systemie Linux) lub AZ_BATCH_APP_PACKAGE_FOO#1 (w systemie Windows). AZ_BATCH_APP_PACKAGE_FOO_1 wskazuje lokalizację pobranego pakietu (folder). W przypadku korzystania z domyślnej wersji pakietu aplikacji użyj zmiennej środowiskowej AZ_BATCH_APP_PACKAGE bez numerów wersji. Jeśli w systemie Linux, a nazwa pakietu aplikacji to "Agent-linux-x64", a wersja to "1.1.46.0", nazwa środowiska jest w rzeczywistości: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, używając podkreśleń i małych liter. Aby uzyskać więcej informacji, zobacz Wykonywanie zainstalowanych aplikacji , aby uzyskać więcej informacji. Każde zadanie ze skojarzonym pakietem aplikacji. Dostępne również dla wszystkich zadań, jeśli sam węzeł ma pakiety aplikacji. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) lub AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Token uwierzytelniania, który udziela dostępu do ograniczonego zestawu operacji usługi Batch. Ta zmienna środowiskowa jest obecna tylko wtedy, gdy parametr authenticationToken Ustawienia jest ustawiany podczas dodawania zadania. Wartość tokenu jest używana w interfejsach API usługi Batch jako poświadczenia do tworzenia klienta usługi Batch, takiego jak w interfejsie API platformy .NET usługi BatchClient.Open(). Token nie obsługuje sieci prywatnej. Wszystkie zadania. Token dostępu OAuth2
AZ_BATCH_CERTIFICATES_DIR Katalog w katalogu roboczym zadania, w którym certyfikaty są przechowywane dla węzłów obliczeniowych systemu Linux. Ta zmienna środowiskowa nie ma zastosowania do węzłów obliczeniowych systemu Windows. Wszystkie zadania. /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST Lista węzłów przydzielonych do zadania z wieloma wystąpieniami w formacie nodeIP,nodeIP. Podzadania podstawowe i podrzędne z wieloma wystąpieniami. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Określa, czy bieżący węzeł jest węzłem głównym dla zadania z wieloma wystąpieniami. Możliwe wartości to true i false. Podzadania podstawowe i podrzędne z wieloma wystąpieniami. true
AZ_BATCH_JOB_ID Identyfikator zadania, do którego należy zadanie podrzędne. Wszystkie zadania z wyjątkiem zadania podrzędnego uruchamiania. batchjob001
AZ_BATCH_JOB_PREP_DIR Pełna ścieżka katalogu zadań przygotowania zadania w węźle. Wszystkie zadania z wyjątkiem zadania podrzędnego uruchamiania i zadania podrzędnego przygotowania. Dostępne tylko wtedy, gdy zadanie jest skonfigurowane z zadaniem przygotowania zadania. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation
AZ_BATCH_JOB_PREP_WORKING_DIR Pełna ścieżka katalogu roboczego zadania przygotowania zadania w węźle. Wszystkie zadania z wyjątkiem zadania podrzędnego uruchamiania i zadania podrzędnego przygotowania. Dostępne tylko wtedy, gdy zadanie jest skonfigurowane z zadaniem przygotowania zadania. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd
AZ_BATCH_MASTER_NODE Adres IP i port węzła obliczeniowego, na którym jest uruchamiane podstawowe zadanie zadania z wieloma wystąpieniami. Nie używaj portu określonego tutaj dla komunikacji MPI lub NCCL — jest on zarezerwowany dla usługi Azure Batch. Zamiast tego należy użyć zmiennej MASTER_PORT, ustawiając ją z wartością przekazywaną za pośrednictwem argumentu wiersza polecenia (port 6105 jest dobrym wyborem domyślnym) lub używając wartości AML ustawia, jeśli tak. Podzadania podstawowe i podrzędne z wieloma wystąpieniami. 10.0.0.4:6000
AZ_BATCH_NODE_ID Identyfikator węzła, do którego przydzielono zadanie. Wszystkie zadania. tvm-1219235766_3-20160919t172711z
AZ_BATCH_NODE_IS_DEDICATED Jeśli truebieżący węzeł jest węzłem dedykowanym. Jeśli falsejest to węzeł typu spot platformy Azure. Wszystkie zadania. true
AZ_BATCH_NODE_LIST Lista węzłów przydzielonych do zadania z wieloma wystąpieniami w formacie nodeIP;nodeIP. Podzadania podstawowe i podrzędne z wieloma wystąpieniami. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Pełna ścieżka lokalizacji instalacji systemu plików na poziomie węzła, w której znajdują się wszystkie katalogi instalacji. Udziały plików systemu Windows używają litery dysku, więc w przypadku systemu Windows dysk instalacji jest częścią urządzeń i dysków. Wszystkie zadania, w tym zadanie uruchamiania, mają dostęp do użytkownika, biorąc pod uwagę, że użytkownik ma świadomość uprawnień instalacji dla zainstalowanego katalogu. Na przykład w systemie Ubuntu lokalizacja to: /mnt/batch/tasks/fsmounts
AZ_BATCH_NODE_ROOT_DIR Pełna ścieżka katalogu głównego wszystkich katalogów usługi Batch w węźle. Wszystkie zadania. C:\user\tasks
AZ_BATCH_NODE_SHARED_DIR Pełna ścieżka katalogu udostępnionego w węźle. Wszystkie zadania wykonywane w węźle mają dostęp do odczytu/zapisu do tego katalogu. Zadania wykonywane w innych węzłach nie mają dostępu zdalnego do tego katalogu (nie jest to katalog sieciowy "udostępniony"). Wszystkie zadania. C:\user\tasks\shared
AZ_BATCH_NODE_STARTUP_DIR Pełna ścieżka katalogu zadań uruchamiania w węźle. Wszystkie zadania. C:\user\tasks\startup
AZ_BATCH_POOL_ID Identyfikator puli, w której jest uruchamiane zadanie podrzędne. Wszystkie zadania. batchpool001
AZ_BATCH_TASK_DIR Pełna ścieżka katalogu zadań w węźle. Ten katalog zawiera element stdout.txt i stderr.txt dla zadania oraz AZ_BATCH_TASK_WORKING_DIR. Wszystkie zadania. C:\user\tasks\workitems\batchjob001\job-1\task001
AZ_BATCH_TASK_ID Identyfikator bieżącego zadania. Wszystkie zadania z wyjątkiem zadania podrzędnego uruchamiania. zadanie001
AZ_BATCH_TASK_SHARED_DIR Ścieżka katalogu, która jest identyczna dla zadania podstawowego i każdej podzadaku zadania z wieloma wystąpieniami. Ścieżka istnieje w każdym węźle, na którym jest uruchamiane zadanie z wieloma wystąpieniami i jest dostępna do odczytu/zapisu dla poleceń zadań uruchomionych w tym węźle (zarówno polecenie koordynacji, jak i polecenie aplikacji. Podzadania lub zadanie podstawowe wykonywane w innych węzłach nie mają dostępu zdalnego do tego katalogu (nie jest to katalog sieciowy "udostępniony"). Podzadania podstawowe i podrzędne z wieloma wystąpieniami. C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask
AZ_BATCH_TASK_WORKING_DIR Pełna ścieżka katalogu roboczego zadania w węźle. Aktualnie uruchomione zadanie ma dostęp do odczytu/zapisu do tego katalogu. Wszystkie zadania. C:\user\tasks\workitems\batchjob001\job-1\task001\wd
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES Bieżący próg miejsca na dysku, na którym maszyna wirtualna zostanie oznaczona jako DiskFull. Wszystkie zadania. 1000000
CCP_NODES Lista węzłów i liczby rdzeni na węzeł przydzielonych do zadania z wieloma wystąpieniami. Węzły i rdzenie są wyświetlane w formacie numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., gdzie liczba węzłów następuje co najmniej jeden adres IP węzła i liczba rdzeni dla każdego.		 Podzadania podstawowe i podrzędne z wieloma wystąpieniami. 2 10.0.0.4 1 10.0.0.5 1

Następne kroki