Condividi tramite

Variabili di ambiente di runtime di Azure Batch

Il servizio Azure Batch imposta le variabili di ambiente seguenti nei nodi di calcolo. È possibile fare riferimento a queste variabili di ambiente nelle righe di comando delle attività e nei programmi e negli script eseguiti dalle righe di comando.

Per altre informazioni sull'uso delle variabili di ambiente con Batch, vedere Impostazioni di ambiente per le attività.

Visibilità delle variabili d'ambiente

Queste variabili di ambiente sono visibili solo nel contesto dell'utente dell'attività, ovvero l'account utente nel nodo in cui viene eseguita un'attività. Queste variabili non verranno visualizzate quando ci si connette in remoto a un nodo di calcolo tramite Remote Desktop Protocol (RDP) o Secure Shell (SSH) e si elencano le variabili di ambiente. Ciò è dovuto al fatto che l'account utente utilizzato per la connessione remota non è lo stesso dell'account utilizzato dall'attività.

Per ottenere il valore corrente di una variabile di ambiente, avviare cmd.exe su un nodo di calcolo Windows o /bin/sh su un nodo Linux:

cmd /c set <ENV_VARIABLE_NAME>

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

Espansione da riga di comando delle variabili d'ambiente

Le righe di comando eseguite dalle attività nei nodi di calcolo non vengono eseguite in una shell. Ciò significa che queste righe di comando non possono utilizzare in modo nativo le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente (incluso ).PATH Per utilizzare tali funzionalità, è necessario richiamare la shell nella riga di comando. Ad esempio, avviare cmd.exe nei nodi di calcolo Windows o /bin/sh nei nodi Linux:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Variabili di ambiente

Annotazioni

AZ_BATCH_AUTHENTICATION_TOKEN è deprecato e verrà ritirato il 30 settembre 2024. Consulta l'annuncio per i dettagli e l'implementazione alternativa.

Nome variabile Descrizione Disponibilità Esempio
AZ_BATCH_ACCOUNT_NAME Nome dell'account Batch a cui appartiene l'attività. Tutte le attività. mybatchaccount
AZ_BATCH_ACCOUNT_URL URL dell'account Batch. Tutte le attività. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE Prefisso di tutte le variabili di ambiente del pacchetto dell'app. Ad esempio, se l'applicazione "FOO" versione "1" è installata in un pool, la variabile di ambiente è AZ_BATCH_APP_PACKAGE_FOO_1 (in Linux) o AZ_BATCH_APP_PACKAGE_FOO#1 (in Windows). AZ_BATCH_APP_PACKAGE_FOO_1 punta al percorso in cui è stato scaricato il pacchetto (una cartella). Quando usi la versione predefinita del pacchetto dell'app, usa la variabile di ambiente AZ_BATCH_APP_PACKAGE senza i numeri di versione. Se in Linux il nome del pacchetto dell'applicazione è "Agent-linux-x64" e la versione è "1.1.46.0, il nome dell'ambiente è in realtà: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, utilizzando caratteri di sottolineatura e minuscoli. Per ulteriori informazioni, vedere Esecuzione delle applicazioni installate per ulteriori dettagli. Qualsiasi attività con un pacchetto dell'app associato. Disponibile anche per tutte le attività se il nodo stesso dispone di pacchetti applicativi. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) o AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN Token di autenticazione che concede l'accesso a un set limitato di operazioni del servizio Batch. Questa variabile di ambiente è presente solo se authenticationTokenSettings è impostata quando viene aggiunta l'attività. Il valore del token viene usato nelle API Batch come credenziali per creare un client Batch, ad esempio nell'API .NET BatchClient.Open(). Il token non supporta la rete privata. Tutte le attività. Token di accesso OAuth2
AZ_BATCH_CERTIFICATES_DIR Directory all'interno della directory di lavoro dell'attività in cui vengono archiviati i certificati per i nodi di calcolo Linux. Questa variabile di ambiente non si applica ai nodi di calcolo Windows. Tutte le attività. /mnt/batch/attività/workitems/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST L'elenco dei nodi allocati a un'attività a più istanze nel formato nodeIP,nodeIP. Attività primarie e secondarie a più istanze. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Specifica se il nodo corrente è il nodo master per un'attività a più istanze. I valori possibili sono true e false. Attività primarie e secondarie a più istanze. true
AZ_BATCH_JOB_ID L'ID del processo a cui appartiene l'attività. Tutte le attività tranne l'attività di avvio. batchjob001
AZ_BATCH_JOB_PREP_DIR Percorso completo della directory delle attività di preparazione del processo nel nodo. Tutte le attività tranne l'attività di avvio e l'attività di preparazione del processo. Disponibile solo se il processo è configurato con un'attività di preparazione del processo. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR Percorso completo della directory di lavoro dell'attività di preparazione del processo nel nodo. Tutte le attività tranne l'attività di avvio e l'attività di preparazione del processo. Disponibile solo se il processo è configurato con un'attività di preparazione del processo. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE L'indirizzo IP e la porta del nodo di calcolo in cui viene eseguita l'attività principale di un'attività a più istanze . Non usare la porta specificata qui per la comunicazione MPI o NCCL: è riservata al servizio Azure Batch. Utilizzare invece la variabile MASTER_PORT, impostandola con un valore passato tramite l'argomento della riga di comando (la porta 6105 è una buona scelta predefinita) o utilizzando il valore impostato da AML se lo fa. Attività primarie e secondarie a più istanze. 10.0.0.4:6000
AZ_BATCH_NODE_ID ID del nodo a cui è assegnata l'attività. Tutte le attività. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Se true, il nodo corrente è un nodo dedicato. Se false, si tratta di un nodo Spot di Azure. Tutte le attività. true
AZ_BATCH_NODE_LIST L'elenco dei nodi allocati a un'attività a più istanze nel formato nodeIP;nodeIP. Attività primarie e secondarie a più istanze. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR Il percorso completo della posizione di montaggio del file system a livello di nodo in cui risiedono tutte le directory di montaggio. Le condivisioni file di Windows usano una lettera di unità, quindi per Windows l'unità di montaggio fa parte dei dispositivi e delle unità. Tutte le attività, inclusa l'attività di avvio, hanno accesso all'utente, a condizione che l'utente sia a conoscenza dei permessi di montaggio per la directory montata. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Percorso completo della radice di tutte le directory Batch nel nodo. Tutte le attività. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Percorso completo della directory condivisa nel nodo. Tutte le attività eseguite su un nodo hanno accesso in lettura/scrittura a questa directory. Le attività eseguite su altri nodi non dispongono dell'accesso remoto a questa directory (non si tratta di una directory di rete "condivisa"). Tutte le attività. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Percorso completo della directory dell'attività iniziale nel nodo. Tutte le attività. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID ID del pool in cui è in esecuzione l'attività. Tutte le attività. batchpool001
AZ_BATCH_TASK_DIR Percorso completo della directory delle attività nel nodo. Questa directory contiene il stdout.txt e stderr.txt per l'attività e il AZ_BATCH_TASK_WORKING_DIR. Tutte le attività. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID ID dell'attività corrente. Tutte le attività tranne l'attività di avvio. compito001
AZ_BATCH_TASK_SHARED_DIR Percorso di directory identico per l'attività principale e per ogni sottoattività di un'attività a più istanze. Il percorso esiste in ogni nodo in cui viene eseguita l'attività a più istanze ed è accessibile in lettura/scrittura ai comandi dell'attività in esecuzione in tale nodo (sia il comando di coordinamento che il comando dell'applicazione. Le sottoattività o un'attività primaria eseguite su altri nodi non dispongono dell'accesso remoto a questa directory (non si tratta di una directory di rete "condivisa"). Attività primarie e secondarie a più istanze. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR Percorso completo della directory di lavoro dell'attività nel nodo. L'attività attualmente in esecuzione dispone dell'accesso in lettura/scrittura a questa directory. Tutte le attività. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES Soglia corrente per lo spazio su disco in base alla quale la macchina virtuale verrà contrassegnata come DiskFull. Tutte le attività. 1000000
CCP_NODES Elenco dei nodi e numero di core per nodo allocati a un'attività a più istanze. I nodi e i core sono elencati nel formato numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., dove il numero di nodi è seguito da uno o più indirizzi IP dei nodi e dal numero di core per ciascuno di essi.		 Attività primarie e secondarie a più istanze. 2 10.0.0.4 1 10.0.0.5 1

Importante

I valori esatti per i percorsi per le variabili di ambiente sono considerati dettagli di implementazione e sono soggetti a modifiche. Utilizzare le variabili di ambiente fornite da Batch invece di tentare di creare rappresentazioni di percorso non elaborate.

La tabella seguente specifica i valori di ogni suffisso del valore della variabile di ambiente dopo il valore AZ_BATCH_NODE_ROOT_DIR, vedere AZ_BATCH_NODE_ROOT_DIR per ulteriori informazioni.

Nome di variabile di ambiente Suffisso della directory del valore della variabile d'ambiente
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

Le directory dei processi sono diverse tra il processo a esecuzione singola e la pianificazione dei processi. Nella tabella seguente vengono specificati i valori della directory dei processi in un processo a esecuzione singola e nella pianificazione dei processi.

Tipo di lavoro Suffisso del valore della directory dei lavori dopo AZ_BATCH_NODE_ROOT_DIR
Lavoro workitems\{job name}\job-1
Pianificazione processi workitems\{job schedule name}\{job name}

Nella tabella seguente vengono specificati i valori di ogni suffisso del valore della variabile di ambiente dopo la directory dei processi.

Nome di variabile di ambiente Suffisso dopo la directory dei lavori della directory dei valori delle variabili d'ambiente
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

Passaggi successivi