Variáveis de ambiente de tempo de execução do Azure Batch

  • Artigo

O serviço Batch do Azure define as seguintes variáveis de ambiente em nós de computação. Você pode fazer referência a essas variáveis de ambiente nas linhas de comando da tarefa e nos programas e scripts executados pelas linhas de comando.

Para obter mais informações sobre como usar variáveis de ambiente com Batch, consulte Configurações de ambiente para tarefas.

Visibilidade variável do ambiente

Essas variáveis de ambiente são visíveis apenas no contexto do usuário da tarefa, que é a conta de usuário no nó sob o qual uma tarefa é executada. Você não verá essas variáveis ao se conectar remotamente a um nó de computação via RDP (Remote Desktop Protocol) ou SSH (Secure Shell) e listar variáveis de ambiente. Isto deve-se ao facto de a conta de utilizador utilizada na ligação remota não ser a mesma conta utilizada pela tarefa.

Para obter o valor atual de uma variável de ambiente, inicie cmd.exe em um nó de computação do Windows ou /bin/sh em um nó 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 em nós de computação não são executadas sob um shell. Isso significa que essas linhas de comando não podem usar nativamente recursos de shell, como expansão de variável de ambiente (incluindo o PATH). Para usar 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

Nota

AZ_BATCH_AUTHENTICATION_TOKEN está preterido e será aposentado em 30 de setembro de 2024. Consulte o anúncio para obter detalhes e implementação alternativa.

Nome da variável Descrição Disponibilidade Exemplo
AZ_BATCH_ACCOUNT_NAME O nome da conta Batch à qual a tarefa pertence. Todas as tarefas. mybatchaccount
AZ_BATCH_ACCOUNT_URL A URL da conta de 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 do aplicativo. Por exemplo, se o aplicativo "FOO" versão "1" estiver 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 aponta para o local em que 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 no Linux, e o nome do pacote do aplicativo é "Agent-linux-x64" e a versão é "1.1.46.0, o nome do ambiente é, na verdade: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, usando sublinhados e minúsculas. Para obter mais informações, consulte Executar os aplicativos instalados para obter mais detalhes. 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 de serviço em lote. Essa variável de ambiente só estará presente se authenticationTokenSettings for definida quando a tarefa for adicionada. O valor do token é usado nas APIs de lote como credenciais para criar um cliente de lote, como na API .NET BatchClient.Open(). O token não suporta rede privada. Todas as tarefas. Token de acesso 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. Esta variável de ambiente não se aplica a 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 para uma tarefa de várias instâncias no formato nodeIP,nodeIP. Tarefas primárias e subtarefas de várias instâncias. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER Especifica se o nó atual é o nó mestre para uma tarefa de várias instâncias. Os valores possíveis são true e false. Tarefas primárias e subtarefas de várias instâncias. true
AZ_BATCH_JOB_ID O ID do trabalho ao qual a tarefa pertence. Todas as tarefas, exceto iniciar tarefa. batchjob001
AZ_BATCH_JOB_PREP_DIR O caminho completo do diretório de tarefas de preparação de trabalho no nó. Todas as tarefas, exceto iniciar tarefa e tarefa de preparação de trabalho. Disponível apenas se o trabalho estiver configurado com uma tarefa de preparação de trabalho. C:\usuário\tarefas\workitems\jobprepreleasesamplejob\job-1\jobpreparation
AZ_BATCH_JOB_PREP_WORKING_DIR O caminho completo do diretório de trabalho da tarefa de preparação de trabalho no nó. Todas as tarefas, exceto iniciar tarefa e tarefa de preparação de trabalho. Disponível apenas se o trabalho estiver configurado com uma tarefa de preparação de trabalho. C:\usuário\tarefas\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 comunicação MPI ou NCCL - ela está reservada para o serviço Azure Batch. Use a variável MASTER_PORT em vez disso, definindo-a com um valor passado através do argumento de linha de comando (a porta 6105 é uma boa opção padrão) ou usando o valor que AML define se fizer isso. Tarefas primárias e subtarefas de várias instâncias. 10.0.0.4:6000
AZ_BATCH_NODE_ID A ID do nó ao qual a tarefa está atribuída. Todas as tarefas. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED Se true, o nó atual é um nó dedicado. Se false, é um nó do Azure Spot. Todas as tarefas. true
AZ_BATCH_NODE_LIST A lista de nós alocados para uma tarefa de várias instâncias no formato nodeIP;nodeIP. Tarefas primárias e subtarefas de várias instâncias. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR O caminho completo do local de montagem do sistema de arquivos no nível do nó onde residem todos os diretórios de montagem. Os compartilhamentos de arquivos do Windows usam uma letra de 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, a localização é: /mnt/batch/tasks/fsmounts
AZ_BATCH_NODE_ROOT_DIR O caminho completo da raiz de todos os diretórios Batch no nó. Todas as tarefas. C:\usuário\tarefas
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. As tarefas executadas em outros nós não têm acesso remoto a este diretório (não é um diretório de rede "compartilhado"). Todas as tarefas. C:\usuário\tarefas\shared
AZ_BATCH_NODE_STARTUP_DIR O caminho completo do diretório de tarefas iniciar no nó. Todas as tarefas. C:\usuário\tarefas\inicialização
AZ_BATCH_POOL_ID O ID do conjunto no qual a tarefa é executada. Todas as tarefas. batchpool001
AZ_BATCH_TASK_DIR O caminho completo do diretório de tarefas no nó. Este diretório contém o e para a tarefa e stderr.txt o stdout.txt AZ_BATCH_TASK_WORKING_DIR. Todas as tarefas. C:\usuário\tarefas\workitems\batchjob001\job-1\task001
AZ_BATCH_TASK_ID O ID da tarefa atual. Todas as tarefas, exceto iniciar tarefa. tarefa001
AZ_BATCH_TASK_SHARED_DIR Um caminho de diretório idêntico para a tarefa principal e cada subtarefa de uma tarefa de várias instâncias. O caminho existe em cada nó no qual a tarefa de várias instâncias é executada e é acessível para leitura/gravação acessível aos comandos da tarefa em execução nesse nó (tanto o comando coordination quanto o comando application. Subtarefas ou uma tarefa primária que é executada em outros nós não têm acesso remoto a este diretório (não é um diretório de rede "compartilhado"). Tarefas primárias e subtarefas de várias instâncias. C:\usuário\tarefas\workitems\multiinstancesamplejob\job-1\multiinstancesampletask
AZ_BATCH_TASK_WORKING_DIR O caminho completo do diretório de trabalho da tarefa no nó. A tarefa atualmente em execução tem acesso de leitura/gravação a este diretório. Todas as tarefas. C:\usuário\tarefas\workitems\batchjob001\job-1\task001\wd
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES O limite atual de espaço em disco no qual a VM será marcada como DiskFull. Todas as tarefas. 1000000
CCP_NODES A lista de nós e o número de núcleos por nó alocados para uma tarefa de várias instâncias. Os nós e núcleos são listados no formato numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ..., onde o número de nós é seguido por um ou mais endereços IP de nó e o número de núcleos para cada um.		 Tarefas primárias e subtarefas de várias instâncias. 2 10.0.0.4 1 10.0.0.5 1

Próximos passos