Proměnné prostředí modulu runtime Služby Azure Batch

  • Článek

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, který je používán úkolem.

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í proměnných prostředí příkazového řádku

Příkazové řádky spouštěné úlohami na výpočetních uzlech se nespustí v prostředí. To znamená, že tyto příkazové řádky nemůžou nativně používat funkce prostředí, jako je rozšíření proměnné prostředí (včetně ).PATH Pokud chcete takové funkce použít, musíte vyvolat prostředí na 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. 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 aplikace FOO verze 1 nainstalovaná do fondu, proměnná prostředí je 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 v Linuxu a název balíčku aplikace je Agent-linux-x64 a verze je 1.1.46.0, název prostředí je ve skutečnosti: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0 pomocí podtržítka a malých písmen. 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 je při přidání úlohy nastaveno ověřováníToken Nastavení. 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 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. Primární a dílčí úkoly s více instancemi 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Určuje, jestli je aktuální uzel hlavním uzlem pro úlohu s více instancemi. Možné hodnoty jsou true a false. Primární a dílčí úkoly s více instancemi true
AZ_BATCH_JOB_ID Číslo ID úlohy, ke které úkol patří. Všechny úkoly s výjimkou spouštěcího úkolu. batchjob001
AZ_BATCH_JOB_PREP_DIR Úplná cesta k adresáři úkolů přípravy úlohy na uzlu. Všechny úkoly kromě úkolu zahájení a přípravy úlohy. K dispozici pouze v případě, že je úloha nakonfigurovaná s přípravným úkolem úlohy. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation
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 přípravy úlohy. K dispozici pouze v případě, že je úloha nakonfigurovaná s přípravným úkolem úlohy. C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd
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 tak, že ji nastavíte s hodnotou předanou prostřednictvím argumentu příkazového řádku (port 6105 je dobrou výchozí volbou) nebo použijete hodnotu, pokud ano. Primární a dílčí úkoly s více instancemi 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. Primární a dílčí úkoly s více instancemi 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í. Například v Ubuntu je umístění: /mnt/batch/tasks/fsmounts
AZ_BATCH_NODE_ROOT_DIR Úplná cesta kořenového adresáře všech adresářů Batch v uzlu. Všechny úkoly. C:\user\tasks
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. C:\user\tasks\shared
AZ_BATCH_NODE_STARTUP_DIR Úplná cesta ke spouštěcímu adresáři úkolů v uzlu. Všechny úkoly. C:\user\tasks\startup
AZ_BATCH_POOL_ID Číslo ID fondu, ve kterém je spuštěn úkol. Všechny úkoly. batchpool001
AZ_BATCH_TASK_DIR Úplná cesta k adresáři úloh v uzlu. Tento adresář obsahuje a stdout.txtstderr.txt pro úkol a AZ_BATCH_TASK_WORKING_DIR. Všechny úkoly. C:\user\tasks\workitems\batchjob001\job-1\task001
AZ_BATCH_TASK_ID Číslo ID aktuálního úkolu. Všechny úkoly s výjimkou spouštěcího úkolu. task001
AZ_BATCH_TASK_SHARED_DIR Cesta k adresáři, která je stejná pro primární úlohu a každé dílčí úkoly 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ář). Primární a dílčí úkoly s více instancemi C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask
AZ_BATCH_TASK_WORKING_DIR Úplná cesta pracovního adresáře úkolu na uzlu. Aktuálně spuštěná úloha má k tomuto adresáři přístup pro čtení a zápis. Všechny úkoly. C:\user\tasks\workitems\batchjob001\job-1\task001\wd
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES 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.		 Primární a dílčí úkoly s více instancemi 2 10.0.0.4 1 10.0.0.5 1

Další kroky