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 tempo de execução. Essas variáveis podem ser definidas como entradas manuais ou como referências a segredos. Essas variáveis de ambiente são carregadas em seu aplicativo de contêiner durante o tempo de execução.

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 nova revisão.

Nota

Para evitar confusão, não é recomendado duplicar 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 estiver a criar uma nova Aplicação de Contentor através do portal do Azure, pode configurar as variáveis de ambiente na secção Contentor:

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 --env-vars parâmetro.

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 quiser fazer referência a um segredo, tem de se certificar de que o segredo que pretende referenciar já foi criado, consulte Gerir segredos. Você pode usar o nome secreto 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, você precisa, primeiro, criar um objeto na memória chamado EnvironmentVar usando o cmdlet New-AzContainerAppEnvironmentVarObject PowerShell.

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

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

Se quiser fazer referência a um segredo, tem de se certificar de que o segredo que pretende referenciar já foi criado, consulte Gerir segredos. Você pode usar o nome secreto e passá-lo para o -SecretRef parâmetro:

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

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

Neste cmdlet, você precisa passar o nome da imagem do contêiner (não o aplicativo do contêiner!) desejado usando o -Name parâmetro, o nome da imagem totalmente qualificada usando o -Image parâmetro 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

Nota

Observe que há outras configurações que você pode precisar definir dentro do objeto de modelo para evitar substituí-las, como recursos, montagens de volume, etc. Verifique a documentação completa sobre este modelo em New-AzContainerAppTemplateObject.

Finalmente, você pode atualizar seu Container App com base no novo objeto de modelo criado usando o cmdlet Update-AzContainerApp PowerShell.

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

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 nova revisão com as alterações necessárias.

Portal do Azure

1. No portal do Azure, procure Aplicativos de Contêiner e selecione seu aplicativo.

   

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

   

3. Em seguida, você tem que 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 Ambiente e a Origem (pode ser uma referência a um segredo).

   

   1. Se você selecionar a fonte 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 quiser criar várias variáveis de ambiente, você pode inserir valores separados por espaço no formato 'key=value'.

Se quiser fazer referência a um segredo, tem de se certificar de que o segredo que pretende referenciar já foi criado, consulte Gerir segredos. Você pode usar o nome secreto e passá-lo para o campo de valor, mas começando com secretref:, veja 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 novo Container App, você precisa criar um objeto chamado EnvironmentVar, que está contido em um Container. Esse contêiner é usado com o cmdlet New-AzContainerApp 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 incorporadas

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.

Aplicações

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

Nome da variável	Description	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 de host específico da revisão do aplicativo contêiner.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	O sufixo DNS para o ambiente Container Apps. Para obter o nome de domínio totalmente qualificado (FQDN) 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

Tarefas

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

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

Próximos passos

• Gestão de revisões