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:ysecretRefpara que el valor del secreto no aparezca en el YAML o en el historial del shell - Usar YAML: mejora la consistencia