Administración de variables de entorno en Azure Container Apps

En Azure Container Apps, puede establecer variables de entorno en tiempo de ejecución. Estas variables se pueden establecer como entradas manualmente o como referencias a secretos. Estas variables de entorno se cargan en la aplicación contenedora durante el tiempo de ejecución.

Configuración de las variables de entorno

Puede configurar las variables de entorno al crear la aplicación contenedora o más tarde creando una nueva revisión.

Nota:

Para evitar confusiones, no se recomienda duplicar variables de entorno. Cuando varias variables de entorno tienen el mismo nombre, surte efecto la última de la lista.

Azure Portal

Si va a crear una nueva aplicación de contenedor a través de Azure Portal, puede configurar las variables de entorno en la sección Contenedor:

CLI de Azure

Puede crear su aplicación contenedora con variables de entorno usando el comando az containerapp create pasando las variables de entorno como entradas 'clave=valor' separadas por espacios usando el 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

Si quiere hacer referencia a un secreto, tiene que asegurarse de que el secreto al que quiere hacer referencia ya está creado, consulte Administrar secretos. Puede usar el nombre secreto y pasarlo al campo de valor pero empezando por secretref:

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

PowerShell

Si quiere usar PowerShell tiene que, en primer lugar, crear un objeto en memoria llamado EnvironmentVar usando el cmdlet New-AzContainerAppEnvironmentVarObject de PowerShell.

Para usar este cmdlet, tiene que pasar el nombre de la variable de entorno usando el parámetro -Name y el valor usando el parámetro -Value, respectivamente.

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

Si quiere hacer referencia a un secreto, tiene que asegurarse de que el secreto al que quiere hacer referencia ya está creado, consulte Administrar secretos. Puede usar el nombre del secreto y pasarlo al parámetro -SecretRef:

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

Después tendrá que crear otro objeto en memoria llamado Container usando el cmdlet New-AzContainerAppTemplateObject de PowerShell.

En este cmdlet, tiene que pasar el nombre de la imagen de contenedor (no de la aplicación contenedora) que quiera usando el parámetro -Name, el nombre completo de la imagen usando el parámetro -Image y hacer referencia al objeto de entorno que definió anteriormente en la variable $envVar.

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

Nota:

Tenga en cuenta que hay otras configuraciones que es posible que deba definir dentro del objeto de plantilla para evitar invalidarlos como recursos, montajes de volumen, etc. Consulte la documentación completa sobre esta plantilla en New-AzContainerAppTemplateObject.

Por último, puede actualizar su aplicación contenedora basándose en el nuevo objeto de plantilla que ha creado usando el cmdlet Update-AzContainerApp de PowerShell.

En este último cmdlet, solo tiene que pasar el objeto de plantilla que definió en la variable $containerTemplate en el paso anterior usando el parámetro -TemplateContainer.

Update-AzContainerApp -TemplateContainer $containerTemplate

Adición de variables de entorno en aplicaciones de contenedor existentes

Una vez creada la aplicación contenedora, la única manera de actualizar las variables de entorno de la aplicación contenedora es mediante la creación de una nueva revisión con los cambios necesarios.

Azure Portal

1. En Azure Portal, busque Container Apps y después seleccione su aplicación.

   

2. En el menú izquierdo de la aplicación, seleccione Revisiones y réplicas > Crear nueva revisión

   

3. A continuación, debe editar la imagen de contenedor existente actual:

   

4. En la sección Variables de entorno, puede agregar nuevas variables de entorno haciendo clic en Agregar.

5. Después establezca el Nombre de su variable de entorno y el Origen (puede ser una referencia a un secreto).

   

   1. Si selecciona el Origen como manual, podrá introducir manualmente el valor de la variable de Entorno.

      

CLI de Azure

Puede actualizar la aplicación contenedora con el comando az containerapp update.

En este ejemplo se crea una variable de entorno con un valor manual (no se hace referencia a un secreto). Reemplace los <PLACEHOLDERS> por sus valores.

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

Si quiere crear varias variables de entorno, puede insertar valores separados por espacios en el formato 'clave=valor'.

Si quiere hacer referencia a un secreto, tiene que asegurarse de que el secreto al que quiere hacer referencia ya está creado, consulte Administrar secretos. Puede usar el nombre secreto y pasarlo al campo de valor pero empezando por secretref:, vea el ejemplo siguiente:

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

PowerShell

De forma similar a lo que hay que hacer al crear una nueva aplicación contenedora, hay que crear un objeto llamado EnvironmentVar, que está contenido dentro de un Contenedor. Este Contenedor se usa después con el cmdlet New-AzContainerApp de PowerShell.

En este cmdlet, solo tiene que pasar el objeto de plantilla que definió anteriormente como se describe en la sección Configurar variables de entorno.

Update-AzContainerApp -TemplateContainer $containerTemplate

Variables de entorno integradas

Azure Container Apps agrega automáticamente variables de entorno que sus aplicaciones y trabajos pueden usar para obtener metadatos de la plataforma en tiempo de ejecución.

Aplicaciones

Las siguientes variables están disponibles para las aplicaciones contenedoras:

Nombre de la variable	Descripción	Valor de ejemplo
CONTAINER_APP_NAME	Nombre de la aplicación de contenedor.	my-containerapp
CONTAINER_APP_REVISION	El nombre de la revisión de la aplicación contenedora.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Nombre de host específico de la revisión de la aplicación contenedora.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Sufijo DNS para el entorno de Container Apps. Para obtener el nombre de dominio completo (FQDN) de la aplicación, anexe el nombre de la aplicación al sufijo DNS en el formato $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	El puerto de destino de la aplicación contenedora.	8080
CONTAINER_APP_REPLICA_NAME	Nombre de la aplicación contenedora.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Trabajos

Las siguientes variables están disponibles para los trabajos de Container Apps:

Nombre de la variable	Descripción	Valor de ejemplo
CONTAINER_APP_JOB_NAME	Nombre del trabajo.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Nombre de la ejecución del trabajo.	my-job-iwpi4il

Pasos siguientes

• Administración de revisiones