Sdílet prostřednictvím

Proměnné běhového prostředí služby Azure Batch

Služba Azure Batch nastaví následující proměnné prostředí na výpočetních uzlech. Na tyto proměnné prostředí můžete odkazovat v příkazových řádcích úloh a v programech a skriptech spouštěných příkazovými řádky.

Další informace o používání proměnných prostředí se službou Batch najdete v tématu Nastavení prostředí pro úlohy.

Viditelnost proměnných prostředí

Tyto proměnné prostředí jsou viditelné pouze v kontextu uživatele úkolu, což je uživatelský účet na uzlu, pod kterým je úkol spuštěn. Tyto proměnné neuvidíte při vzdáleném připojení k výpočetnímu uzlu přes protokol RDP (Remote Desktop Protocol) nebo Secure Shell (SSH) a výpis proměnných prostředí. Je to proto, že uživatelský účet, který se používá pro vzdálené připojení, není stejný jako účet používaný úlohou.

Pokud chcete získat aktuální hodnotu proměnné prostředí, spusťte cmd.exe ji na výpočetním uzlu Windows nebo /bin/sh na linuxovém uzlu:

cmd /c set <ENV_VARIABLE_NAME>

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

Rozšíření příkazového řádku proměnných prostředí

Příkazové řádky spouštěné úlohami na výpočetních uzlech se nespustí v prostředí shellu. To znamená, že tyto příkazové řádky nemůžou nativně používat funkce shellu, například rozšíření proměnných prostředí (včetně PATH). Pokud chcete takové funkce použít, musíte vyvolat shell v příkazovém řádku. Například spuštění cmd.exe na výpočetních uzlech Windows nebo /bin/sh na linuxových uzlech:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Proměnné prostředí

Poznámka:

AZ_BATCH_AUTHENTICATION_TOKEN je zastaralý a bude vyřazen 30. září 2024. Podrobnosti a alternativní implementaci najdete v oznámení .

Název proměnné Popis Dostupnost Příklad
AZ_BATCH_ACCOUNT_NAME Název účtu Batch, do kterého úkol patří. Všechny úkoly. účet mybatchaccount
AZ_BATCH_ACCOUNT_URL Adresa URL účtu Batch. Všechny úkoly. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Předpona všech proměnných prostředí balíčku aplikace. Pokud je například do poolu nainstalována aplikace FOO verze 1, pak se proměnná prostředí nazývá AZ_BATCH_APP_PACKAGE_FOO_1 (v Linuxu) nebo AZ_BATCH_APP_PACKAGE_FOO#1 (ve Windows). AZ_BATCH_APP_PACKAGE_FOO_1 odkazuje na umístění, kam byl balíček stažen (složka). Pokud používáte výchozí verzi balíčku aplikace, použijte proměnnou prostředí AZ_BATCH_APP_PACKAGE bez čísel verzí. Pokud se nacházíte v Linuxu a název balíčku aplikace je "Agent-linux-x64" a verze je "1.1.46.0", skutečný název prostředí bude: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, používající podtržítka a malá písmena. Další informace najdete v tématu Spuštění nainstalovaných aplikací . Jakýkoli úkol s přidruženým balíčkem aplikace K dispozici také pro všechny úlohy, pokud samotný uzel obsahuje balíčky aplikací. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) nebo AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Ověřovací token, který uděluje přístup k omezené sadě operací služby Batch. Tato proměnná prostředí je k dispozici pouze v případě, že jsou při přidání úlohy nastavena authenticationTokenSettings. Hodnota tokenu se používá v rozhraních API služby Batch jako přihlašovací údaje k vytvoření klienta Batch, například v rozhraní .NET API BatchClient.Open(). Token nepodporuje privátní sítě. Všechny úkoly. Přístupový token OAuth2
AZ_BATCH_CERTIFICATES_DIR Adresář v pracovním adresáři úkolu , ve kterém jsou certifikáty uložené pro výpočetní uzly Linuxu. Tato proměnná prostředí se nevztahuje na výpočetní uzly systému Windows. Všechny úkoly. /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST Seznam uzlů, které jsou přiděleny k úloze s více instancemi ve formátu nodeIP,nodeIP. Vícečetné primární a dílčí úkoly 10.0.0.4,10.0.0.5
There might not be an improved translation needed if it's a standard term. However, if translated, it could be "AZ_BATCH_JE_AKTUÁLNÍ_UZEL_HLAVNÍ" but this would depend on context and industry practice. Určuje, jestli je aktuální uzel hlavním uzlem pro úlohu s více instancemi. Možné hodnoty jsou true a false. Vícečetné primární a dílčí úkoly true
AZ_BATCH_JOB_ID ID úlohy, do které úkol patří. Všechny úkoly s výjimkou spouštěcího úkolu. batchjob001 řekl:
AZ_BATCH_JOB_PREP_DIR Úplná cesta k adresáři úkolů pro přípravu úlohy na uzlu. Všechny úkoly kromě úkolu zahájení a úkolu přípravy práce. K dispozici pouze v případě, že je úloha nakonfigurovaná s přípravnou úlohou. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR Úplná cesta pracovního adresáře úkolu přípravy úlohy na uzlu. Všechny úkoly kromě úkolu zahájení a úkolu přípravy práce. K dispozici pouze v případě, že je úloha nakonfigurovaná s přípravnou úlohou. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE IP adresa a port výpočetního uzlu, na kterém běží primární úloha úlohy s více instancemi . Nepoužívejte port zadaný zde pro komunikaci MPI nebo NCCL – je vyhrazený pro službu Azure Batch. Místo toho použijte proměnnou MASTER_PORT tím, že ji nastavíte hodnotou předanou prostřednictvím argumentu příkazového řádku (port 6105 je dobrou výchozí volbou), nebo použijte hodnotu, kterou nastaví AML, pokud ji nastaví. Vícečetné primární a dílčí úkoly 10.0.0.4:6000
AZ_BATCH_NODE_ID ID uzlu, ke kterému je úkol přiřazen. Všechny úkoly. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Pokud trueje aktuální uzel vyhrazeným uzlem. Pokud falsese jedná o spotový uzel Azure. Všechny úkoly. true
AZ_BATCH_NODE_LIST Seznam uzlů, které jsou přiděleny k úloze s více instancemi ve formátu nodeIP;nodeIP. Vícečetné primární a dílčí úkoly 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Úplná cesta k umístění připojení systému souborů na úrovni uzlu, kde se nacházejí všechny adresáře připojení. Sdílené složky Systému Windows používají písmeno jednotky, takže pro Windows je přípojná jednotka součástí zařízení a jednotek. Všechny úkoly, včetně spouštěcího úkolu, mají přístup k uživateli vzhledem k tomu, že uživatel o oprávněních pro připojení připojeného adresáře ví. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Úplná cesta kořenového adresáře všech adresářů Batch v uzlu. Všechny úkoly. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Úplná cesta sdíleného adresáře v uzlu. Všechny úlohy, které se spouští na uzlu, mají přístup pro čtení a zápis k tomuto adresáři. Úlohy, které se spouští na jiných uzlech, nemají vzdálený přístup k tomuto adresáři (nejedná se o sdílený síťový adresář). Všechny úkoly. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Úplná cesta spouštěcího adresáře úloh v uzlu. Všechny úkoly. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID ID fondu, na kterém úloha běží. Všechny úkoly. batchpool001 řekl:
AZ_BATCH_TASK_DIR Úplná cesta k adresáři úloh v uzlu. Tento adresář obsahuje AZ_BATCH_TASK_WORKING_DIR a stdout.txt a stderr.txt pro úlohu. Všechny úkoly. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID ID aktuálního úkolu. Všechny úkoly s výjimkou spouštěcího úkolu. úkol001 řekl:
AZ_BATCH_TASK_SHARED_DIR Cesta k adresáři, která je stejná pro primární úlohu a každý dílčí úkol úkolu s více instancemi. Cesta existuje na každém uzlu, na kterém běží úloha s více instancemi, a je přístupná pro příkazy úkolů spuštěné na tomto uzlu ( koordinační příkaz i příkaz aplikace). Dílčí úkoly nebo primární úloha, které se spouští na jiných uzlech, nemají vzdálený přístup k tomuto adresáři (nejedná se o sdílený síťový adresář). Vícečetné primární a dílčí úkoly AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR Úplná cesta ke pracovnímu adresáři úkolu na uzlu. Aktuálně spuštěná úloha má k tomuto adresáři přístup pro čtení a zápis. Všechny úkoly. AZ_BATCH_TASK_WORKING_DIR
Rezervovaný dočasný prostor na disku pro úlohu dávky v bytech Aktuální prahová hodnota místa na disku, na kterém bude virtuální počítač označen jako DiskFull. Všechny úkoly. 1000000
CCP_NODES Seznam uzlů a počet jader na uzel, které jsou přiděleny úloze s více instancemi. Uzly a jádra jsou uvedené ve formátu numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., kde za počtem uzlů následuje jedna nebo více IP adres uzlu a počet jader pro každý z nich.		 Vícečetné primární a dílčí úkoly 2 10.0.0.4 1 10.0.0.5 1

Důležité

Přesné hodnoty cest pro proměnné prostředí se považují za podrobnosti implementace a můžou se změnit. Místo pokusu o vytvoření reprezentací nezpracované cesty použijte proměnné prostředí poskytnuté systémem Batch.

Následující tabulka určuje hodnoty každé proměnné prostředí s příponou po hodnotě AZ_BATCH_NODE_ROOT_DIR, viz AZ_BATCH_NODE_ROOT_DIR pro více informací.

Název proměnné prostředí Oprava adresáře hodnot proměnných prostředí
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

Adresáře úloh se liší mezi úlohou s jedním spuštěním a plánem úloh. Následující tabulka určuje hodnoty adresáře pro úlohy v jednorázové úloze a harmonogramu úlohy.

Typ úlohy Přípona hodnoty adresáře úloh za AZ_BATCH_NODE_ROOT_DIR
Práce workitems\{job name}\job-1
Plán úloh workitems\{job schedule name}\{job name}

Následující tabulka určuje hodnoty každé hodnoty proměnné prostředí po umístění adresáře úloh.

Název proměnné prostředí Hodnota proměnné prostředí adresářový postfix za adresářem úlohy
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

Další kroky

  • Last updated on