Variáveis de ambiente do runtime do Lote do Azure
O serviço Lote do Azure define as seguintes variáveis de ambiente em nós de computação. Você pode consultar essas variáveis de ambiente nas linhas de comando da tarefa e nos programas e scripts executados pelas linhas de comando.
Para mais informações sobre como usar as variáveis de ambiente com o Lote, consulte Configurações de ambiente para tarefas.
Visibilidade de variável de ambiente
Essas variáveis de ambiente só ficam visíveis no contexto do usuário da tarefa, que é a conta de usuário no nó em que uma tarefa é executada. Você não as vê se conectar-se remotamente a um nó de computação via RDP (Protocolo RDP) ou SSH (Secure Shell) e listar as variáveis de ambiente. Isso ocorre porque a conta de usuário usada para a conexão remota não é igual à conta usada pela tarefa.
Para obter o valor atual de uma variável de ambiente, inicie o cmd.exe em um nó de computação do Windows ou o /bin/sh em um nó do Linux:
cmd /c set <ENV_VARIABLE_NAME>
/bin/sh -c "printenv <ENV_VARIABLE_NAME>"
Expansão de linha de comando de variáveis de ambiente
As linhas de comando executadas por tarefas nos nós de computação não são executadas em um shell. Isso significa que essas linhas de comando não podem usar nativamente recursos shell, como expansão de variável de ambiente (incluindo o PATH). Para aproveitar esses recursos, você deve invocar o shell na linha de comando. Por exemplo, inicie cmd.exe em nós de computação do Windows ou /bin/sh em nós do Linux:
cmd /c MyTaskApplication.exe %MY_ENV_VAR%
/bin/sh -c "MyTaskApplication $MY_ENV_VAR"
Variáveis de ambiente
Observação
AZ_BATCH_AUTHENTICATION_TOKEN está preterido e será desativado em 30 de setembro de 2024. Confira o anúncio para obter detalhes e alternativas de implementação.
| Nome da variável | Descrição | Disponibilidade | Exemplo |
|---|---|---|---|
| AZ_BATCH_ACCOUNT_NAME | O nome da conta do lote à qual a tarefa pertence. | Todas as tarefas. | mybatchaccount |
| AZ_BATCH_ACCOUNT_URL | A URL da conta do Lote. | Todas as tarefas. | https://myaccount.westus.batch.azure.com |
| AZ_BATCH_APP_PACKAGE | Um prefixo de todas as variáveis de ambiente do pacote de aplicativos. Por exemplo, se o aplicativo "FOO" versão "1" for instalado em um pool, a variável de ambiente será AZ_BATCH_APP_PACKAGE_FOO_1 (no Linux) ou AZ_BATCH_APP_PACKAGE_FOO#1 (no Windows). AZ_BATCH_APP_PACKAGE_FOO_1 indica o local onde o pacote foi baixado (uma pasta). Ao usar a versão padrão do pacote do aplicativo, use a variável de ambiente AZ_BATCH_APP_PACKAGE sem os números de versão. Se você estiver no Linux e o nome do pacote de aplicativos for "Agent-Linux-x64" e a versão for "1.1.46.0", o nome do ambiente será: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, usando sublinhados e letras minúsculas. Para obter mais informações, veja Executar os aplicativos instalados. | Qualquer tarefa com um pacote de aplicativo associado. Também disponível para todas as tarefas, se o próprio nó tiver pacotes de aplicativos. | AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) ou AZ_BATCH_APP_PACKAGE_FOO#1 (Windows) |
| AZ_BATCH_AUTHENTICATION_TOKEN | Um token de autenticação que concede acesso a um conjunto limitado de operações para o serviço de lote. Essa variável de ambiente está presente somente se as authenticationTokenSettings estão definidas quando a tarefa for adicionada. O valor do token é usado nas APIs do lote como credenciais para criar um cliente de lote, como na API .NET BatchClient.Open(). O token não dá suporte à rede privada. | Todas as tarefas. | Token de acesso do OAuth2 |
| AZ_BATCH_CERTIFICATES_DIR | Um diretório dentro do diretório de trabalho da tarefa no qual os certificados são armazenados para nós de computação do Linux. Essa variável de ambiente não se aplica aos nós de computação do Windows. | Todas as tarefas. | /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs |
| AZ_BATCH_HOST_LIST | A lista de nós alocados a uma tarefa de várias instâncias no formato nodeIP,nodeIP. |
Várias instâncias principais e subtarefas. | 10.0.0.4,10.0.0.5 |
| AZ_BATCH_IS_CURRENT_NODE_MASTER | Especifica se o nó atual é o nó mestre de uma tarefa de várias instâncias. Os valores possíveis são true e false. |
Várias instâncias principais e subtarefas. | true |
| AZ_BATCH_JOB_ID | A ID do trabalho ao qual a tarefa pertence. | Todas as tarefas exceto a tarefa de inicialização. | batchjob001 |
| AZ_BATCH_JOB_PREP_DIR | O caminho completo do diretório da tarefa de preparação do trabalho no nó. | Todas as tarefas, exceto a tarefa de inicialização e de preparação do trabalho. Disponível apenas se o trabalho for configurado com uma tarefa de preparação de trabalho. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation |
| AZ_BATCH_JOB_PREP_DIR | O caminho completo do diretório de trabalho da tarefa de preparação no nó. | Todas as tarefas, exceto a tarefa de inicialização e de preparação do trabalho. Disponível apenas se o trabalho for configurado com uma tarefa de preparação de trabalho. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd |
| AZ_BATCH_MASTER_NODE | O endereço IP e a porta do nó de computação no qual a tarefa principal de uma tarefa de várias instâncias é executada. Não use a porta especificada aqui para a comunicação MPI ou NCCL; ela está reservada para o serviço do Lote do Azure. Em vez disso, use a variável MASTER_PORT, definindo-a com um valor transmitido por meio do argumento da linha de comando (a porta 6105 é uma boa opção padrão) ou usando o valor de conjuntos de AML se isso for feito. | Várias instâncias principais e subtarefas. | 10.0.0.4:6000 |
| AZ_BATCH_NODE_ID | A ID do nó ao qual a tarefa foi atribuída. | Todas as tarefas. | Tvm-1219235766_3-20160919t172711z |
| AZ_BATCH_NODE_IS_DEDICATED | Se true, o nó atual é um nó dedicado. Se false, ele é um nó do Azure Spot. |
Todas as tarefas. | true |
| AZ_BATCH_NODE_LIST | A lista de nós alocados a uma tarefa de várias instâncias no formato nodeIP;nodeIP. |
Várias instâncias principais e subtarefas. | 10.0.0.4;10.0.0.5 |
| AZ_BATCH_NODE_MOUNTS_DIR | O caminho completo do nível de nó do local de montagem do sistema de arquivos onde todos os diretórios de montagem residem. Os compartilhamentos de arquivos do Windows usam uma letra da unidade, portanto, para o Windows, a unidade de montagem faz parte de dispositivos e unidades. | Todas as tarefas, incluindo a tarefa inicial, têm acesso ao usuário, dado que o usuário está ciente das permissões de montagem para o diretório montado. | No Ubuntu, por exemplo, o local é: /mnt/batch/tasks/fsmounts |
| AZ_BATCH_NODE_ROOT_DIR | O caminho completo da raiz de todos os diretórios do Lote no nó. | Todas as tarefas. | C:\user\tasks |
| AZ_BATCH_NODE_SHARED_DIR | O caminho completo do diretório compartilhado no nó. Todas as tarefas executadas em um nó têm acesso de leitura/gravação a esse diretório. Tarefas executadas em outros nós não têm acesso remoto a esse diretório (não é um diretório de rede "compartilhado"). | Todas as tarefas. | C:\user\tasks\shared |
| AZ_BATCH_NODE_STARTUP_DIR | O caminho completo do diretório de tarefa inicial no nó. | Todas as tarefas. | C:\user\tasks\startup |
| AZ_BATCH_POOL_ID | A ID do pool no qual a tarefa está em execução. | Todas as tarefas. | batchpool001 |
| AZ_BATCH_TASK_DIR | O caminho completo do diretório da tarefa no nó. Esse diretório contém o stdout.txt e stderr.txt para a tarefa e o AZ_BATCH_TASK_WORKING_DIR. |
Todas as tarefas. | C:\user\tasks\workitems\batchjob001\job-1\task001 |
| AZ_BATCH_TASK_ID | A ID da tarefa atual. | Todas as tarefas exceto a tarefa de inicialização. | task001 |
| AZ_BATCH_TASK_SHARED_DIR | Um caminho de diretório idêntico na tarefa principal e em cada subtarefa de uma tarefa de várias instâncias. O caminho existe em cada nó no qual tarefas de várias instâncias são executadas e tem acesso de leitura/gravação aos comandos da tarefa em execução nesse nó (tanto o comando de coordenação quanto o comando do aplicativo). As subtarefas ou uma tarefa principal executada em outros nós não tem acesso remoto a esse diretório (não é um diretório de rede "compartilhado"). | Várias instâncias principais e subtarefas. | C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask |
| AZ_BATCH_TASK_WORKING_DIR | O caminho completo do diretório de trabalho da tarefa no nó. A tarefa em execução no momento tem acesso de leitura/gravação a esse diretório. | Todas as tarefas. | C:\user\tasks\workitems\batchjob001\job-1\task001\wd |
| AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES | O limite atual para o espaço em disco no qual a VM será marcada como DiskFull. |
Todas as tarefas. | 1.000.000 |
| CCP_NODES | A lista de nós e o número de núcleos por nó alocados a uma tarefa de várias instâncias. Nós e núcleos são listados no formato numNodes<space>node1IP<space>node1Cores<space>node2IP<space>node2Cores<space> ..., em que o número de nós é seguido por um ou mais endereços IP de nó e o número de núcleos de cada um. |
Várias instâncias principais e subtarefas. | 2 10.0.0.4 1 10.0.0.5 1 |
Próximas etapas
- Saiba como usar variáveis de ambiente com o Lote.
- Saiba mais sobre arquivos e diretórios no Lote
- Saiba mais sobre tarefas de várias instâncias.