Gerenciar variáveis de ambiente em Aplicativos de Contêiner do Azure

Nos Aplicativos de Contêiner do Azure, você pode definir variáveis de ambiente de runtime. Essas variáveis podem ser definidas manualmente como entradas ou como referências a segredos. Essas variáveis de ambiente são carregadas em seu Aplicativo de Contêiner durante o runtime.

Configurar variáveis de ambiente

Você pode configurar as Variáveis de Ambiente após a criação do Aplicativo de Contêiner ou posteriormente, criando uma revisão.

Observação

Para evitar confusão, não é recomendável duplicar as variáveis de ambiente. Quando várias variáveis de ambiente têm o mesmo nome, a última da lista entra em vigor.

Portal do Azure

Se você estiver criando um Aplicativo de Contêiner por meio do portal do Azure, poderá configurar as variáveis de ambiente na seção Contêiner:

CLI do Azure

Você pode criar seu Aplicativo de Contêiner com variáveis de ambiente usando o comando az containerapp create passando as variáveis de ambiente como entradas 'key=value' separadas por espaço usando o parâmetro --env-vars.

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" ANOTHERENV=anotherenv

Se você quiser fazer referência a um segredo, precisará garantir que o segredo que você deseja referenciar já tenha sido criado, consulte Gerenciar segredos. Você pode usar o nome do segredo e passá-lo para o campo de valor, mas começando com secretref:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

Se você quiser usar o PowerShell, primeiro, crie um objeto na memória chamado EnvironmentVar usando o cmdlet New-AzContainerAppEnvironmentVarObject do PowerShell.

Para usar esse cmdlet, você precisa passar o nome da variável de ambiente usando o parâmetro -Name e o valor usando o parâmetro -Value, respectivamente.

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -Value "envVarvalue"

Se você quiser fazer referência a um segredo, precisará garantir que o segredo que você deseja referenciar já tenha sido criado, consulte Gerenciar segredos. Você pode usar o nome do segredo e passá-lo para o parâmetro -SecretRef:

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -SecretRef "secretName"

Em seguida, você precisa criar outro objeto na memória chamado Container usando o cmdlet New-AzContainerAppTemplateObject do PowerShell.

Nesse cmdlet, você precisa passar o nome da imagem do contêiner (não o aplicativo de contêiner) desejado usando o parâmetro -Name, o nome da imagem totalmente qualificado usando o parâmetro -Image e fazer referência ao objeto de ambiente definido anteriormente na variável $envVar.

$containerTemplate = New-AzContainerAppTemplateObject -Name "container-app-name" -Image "repo/imagename:tag" -Env $envVar

Observação

Observe que há outras configurações que talvez seja necessário definir dentro do objeto de modelo para evitar substituí-las como recursos, montagens de volume etc. Verifique a documentação completa sobre esse modelo em New-AzContainerAppTemplateObject.

Por fim, você pode atualizar seu Aplicativo de Contêiner com base no novo objeto de modelo criado usando o cmdlet Update-AzContainerApp do PowerShell.

Neste último cmdlet, você só precisa passar o objeto de modelo definido na variável $containerTemplate na etapa anterior usando o parâmetro -TemplateContainer.

Update-AzContainerApp -TemplateContainer $containerTemplate

Adicionar variáveis de ambiente em aplicativos de contêiner existentes

Depois que o Aplicativo de Contêiner é criado, a única maneira de atualizar as variáveis de ambiente do Aplicativo de Contêiner é criando uma revisão com as alterações necessárias.

Portal do Azure

1. Entre no portal do Azure, pesquise por Aplicativos de Contêiner e, em seguida, selecione seu aplicativo.

   

2. No menu à esquerda do aplicativo, selecione Revisões e réplicas > Criar revisão

   

3. Em seguida, você precisa editar a imagem de contêiner existente atual:

   

4. Na seção Variáveis de ambiente, você pode adicionar novas variáveis de ambiente clicando em Adicionar.

5. Em seguida, defina o nome da variável de Ambiente e a Origem (pode ser uma referência a um segredo).

   

   1. Se você selecionar a origem como manual, poderá inserir manualmente o valor da variável Ambiente.

      

CLI do Azure

Você pode atualizar seu Aplicativo de Contêiner com o comando az containerapp update.

Este exemplo cria uma variável de ambiente com um valor manual (não fazendo referência a um segredo). Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=<VAR_VALUE>

Se você quiser criar várias variáveis de ambiente, poderá inserir valores separados por espaço no formato 'chave=valor'.

Se você quiser fazer referência a um segredo, precisará garantir que o segredo que você deseja referenciar já tenha sido criado, consulte Gerenciar segredos. Você pode usar o nome do segredo e passá-lo para o campo de valor, mas começando com secretref:; confira o seguinte exemplo:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

Da mesma forma que você precisa fazer ao criar um Aplicativo de Contêiner, você precisa criar um objeto chamado EnvironmentVar contido em um Contêiner. Esse Contêiner é usado com o cmdlet New-AzContainerApp do PowerShell.

Neste cmdlet, você só precisa passar o objeto de modelo definido anteriormente, conforme descrito na seção Configurar variáveis de ambiente.

Update-AzContainerApp -TemplateContainer $containerTemplate

Variáveis de ambiente internas

Os Aplicativos de Contêiner do Azure adicionam automaticamente variáveis de ambiente que seus aplicativos e trabalhos podem usar para obter metadados da plataforma em tempo de execução.

Aplicativos

As seguintes variáveis estão disponíveis para aplicativos de contêiner:

Nome da variável	Descrição	Valor de exemplo
CONTAINER_APP_NAME	O nome do aplicativo de contêiner.	my-containerapp
CONTAINER_APP_REVISION	O nome da revisão do aplicativo de contêiner.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	O nome do host específico da revisão do aplicativo de contêiner.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	O sufixo DNS para o ambiente de Aplicativos de Contêiner. Para obter o FQDN (nome de domínio totalmente qualificado) do aplicativo, acrescente o nome do aplicativo ao sufixo DNS no formato $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	A porta de destino do aplicativo de contêiner.	8080
CONTAINER_APP_REPLICA_NAME	O nome da réplica do aplicativo de contêiner.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Trabalhos

As seguintes variáveis estão disponíveis para trabalhos de Aplicativos de Contêiner:

Nome da variável	Descrição	Valor de exemplo
CONTAINER_APP_JOB_NAME	O nome do trabalho.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	O nome da execução do trabalho.	my-job-iwpi4il

Próximas etapas

• Gerenciamento da revisão