ACA Runtime (env vars & secrets)

Environment variables (nonsensitive settings)

You can add settings during create

az containerapp create -n ai-api -g rg-aca-demo \
	--environment aca-env-demo \
	--image myregistry.azurecr.io/ai-api:v1 \
	--ingress external --target-port 8000 \
	--env-vars LOG_LEVEL=info FEATURE_EMBEDDINGS=true

Or you can update or remove existing ones

az containerapp update -n ai-api -g rg-aca-demo \
	--set-env-vars LOG_LEVEL=debug

Container Apps secrets (sensitive settings)

set a secret

az containerapp secret set -n ai-api -g rg-aca-demo \
	--secrets embeddings-api-key="SOMETHING"

IMPORTANTE

You can map secrets to environment variables without exposing the real value. You reference a secret by setting the environment variable to secretref:<secret-name>

# example of a environment variable referencing a secret
az containerapp update -n ai-api -g rg-aca-demo \
	--set-env-vars EMBEDDINGS_API_KEY=secretref:embeddings-api-key

/IMPORTANTE

YAML para estandarizar runtime config

Es importante usar YAML una vez acabado el prototipado, ya que un cambio pequeño de config puede romper todo.

properties:
  template:
    containers:
      - name: ai-api
        env:
      - name: LOG_LEVEL
        value: info
      - name: EMBEDDINGS_API_KEY
        secretRef: embeddings-api-key

aplicar el YAML

az containerapp update -n ai-api -g rg-aca-demo \
	--yaml ./containerapp.yml

Best practices runtime config

La runtime config debe reducir el riesgo y simplificar operaciones:

  • Separar config de las imágenes: Usar environment variables y secretos para que se pueda reusar la misma imagen entre múltiples entornos
  • Usar secret references: Usar secretref: y secretRef para que el valor del secreto no aparezca en el YAML o en el historial del shell
  • Usar YAML: mejora la consistencia

Additional resources

Manage secrets in Azure Container Apps