ACA Update Images (& manage revisions)

Usar tags y digests intencionalmente

Las tags son convenientes para iteraciones rápidas porque puedes reusar nombres como dev o staging, pero estas pueden cambiar con el tiempo.

Los digests son identificadores inmutables que aportan trazabilidad para PROD.

Update una container app para crear una nueva revisión

Cuando haces update de la imagen de una container app, se crea una nueva revisión con la template actualizada. Se puede verificar la salud de esta revision antes de asignarle tráfico. Esto evita redirigir tráfico en PROD a una revision que falle, por ej., en el startup.

hacer update de la referencia a una imagen

az containerapp update \
	--name <app-name> \
	--resource-group <resource-group> \
	--image myregistry.azurecr.io/myapp@sha256:<digest>

después del update, inspeccionamos la template del contenedor para confirmar el cambio de imagen

az containerapp show \
	--name <app-name> \
	--resource-group <resource-group> \
	--query properties.template.containers

Entender los revision modes y que significa “active”

Los revision modes indican cuantas revisiones pueden estar activas al mismo tiempo.

  • Single revision mode: mantiene activa una única revision, lo que simplifica las operaciones pero limita rollout strategies más avanzadas
  • Multiple revision mode: permite canary rollouts y traffic splitting, para probar nuevas versiones con una pequeña cantidad de tráfico

Listar, investigar y management de revisiones

Las revisions son la unidad que se investiga durante los rollouts. Si las listamos podemos ver cuál está activa y aparte, podemos comparar configuraciones entre una revision que funciona y una que falla.

listar revisions

az containerapp revision list \
	--name <app-name> \
	--resource-group <resource-group> \
	-o table

ver detalles de una revision

az containerapp revision show \
	--name <app-name> \
	--resource-group <resource-group> \
	--revision <revision-name>

Podemos desactivar revisions especificas si queremos. Es más útil desactivarlas que borrarlas como primer paso, ya que podemos investigar con más calma y hacer rollback

az containerapp revision deactivate \
	--name <app-name> \
	--resource-group <resource-group> \
	--revision <revision-name>

Best practices

  • Usar image digests para PROD: los digests son referencias inmutables, no como las tags
  • Verificar la salud de una revision antes de asignarle tráfico: ver revision status, probe signals y logs
  • Desactivar antes de investigar: preserva las pruebas y reduce el riesgo
  • Definir una retention strategy: Container Apps purga automaticamente revisiones inactivas cuando exceden de 100. Esto se puede ajustar mediante --max-inactive-revisions

Additional resources

Application lifecycle management in Azure Container Apps
Update and deploy changes in Azure Container Apps