Revision modes (Azure Container Apps)

Los revision modes en ACA determinan como la app gestiona los deployments y como coexisten múltiples versiones. El mode que elijas afecta a:

  • scaling behavior
  • traffic distribution
  • deployment strategies

Revisions y scaling

IMPORTANTE

Una revision es una captura inmutable de una versión de una container app

Cada vez que cambias config properties y haces un deploy, ACA crea una nueva revision. Las revisiones no se pueden modificar después de ser creadas. Si quieres hacer cambios, tienes que hacer deploy de una nueva revision. La inmutabilidad de las revisions es lo que proporciona estabilidad para hacer rollbacks si una nueva versión da problemas.

/IMPORTANTE

Hay dos tipos de cambios en la container app:

  • revision-scope: cambios que crean una nueva revision e incluyen modificaciones a las container images, scale rules, env variables y otras properties en la sección template de la conf
  • application-scope: cambios que no crean una nueva revision e incluyen modificaciones a secretos, ingress settings y traffic splitting rules

IMPORTANTE

Cada revision activa puede escalar de manera independiente basada en sus propias reglas. Si tienes dos revisiones activas con las mismas scale rules y divides el tráfico entre ellas, cada revision escala basándose en su parte del tráfico.
Este escalado independiente significa que el consumo de recursos a lo largo de todas las revisiones puede ser más alto de lo que consumiría una única revision que gestionara todo ella sola.

Las réplicas son instancias de una revision específica

/IMPORTANTE

Configurar single revision mode

Single revision mode es el valor por defecto para ACA. Solo tenemos una única revision activa en todo momento

Si haces un deploy de cambios que crean una nueva revision:

  • se crea la nueva revision
  • se espera a que esté lista (que pase health checks)
  • se escala al nivel de la anterior
  • se cambia el tráfico a la nueva

Esto garantiza zero-downtime deployments.

La desventaja es que no soporta traffic splitting ni gradual rollouts. Todo el tráfico se cambia de una a otra al momento.

Configurar multiple revision mode

Permite tener múltiples revisions activas de manera simultánea. Esto permite rollouts progresivos, canary releases, blue-green deployments, testing A/B (traffic splitting)

(inciso de términos puestos arriba que yo he llegado a usar)

  • Blue-green deployment: reduce el riesgo de despliegue. consiste en mantener dos entornos idénticos (blue y green) y se cambia el tráfico de uno a otro
  • Canary release: Validar una nueva versión de manera gradual. Envía un pequeño porcentaje de usuarios a la nueva versión y este se va aumentando de manera progresiva
  • A/B testing: medir que opción funciona mejor. diferentes usuarios reciben versiones diferentes de manera deliberada.

(/inciso)

Cada revision recibe tráfico y escala de manera independiente y se mantiene operacional hasta que la desactives a mano de manera explícita. Las revisiones desactivadas se mantienen así por si quieres reactivarlas y volver a asignarles tráfico. ACA soporta hasta 100 revisiones inactivas.

activar multiple mode

az containerapp update \
	--name order-api \
	--resource-group rg-ecommerce \
	--revision-mode multiple

Traffic splitting

Traffic splitting distribuye las incoming requests entre todas las revisiones activas basándose en su porcentaje configurado. Cuando lo configuras lo haces basándote en un 100% (el tráfico real tiene algo de margen para variar).

az containerapp ingress traffic set \
	--name order-api \
	--resource-group rg-ecommerce \
	--revision-weight order-api--v1=80 order-api--v2=20

Al configurar las revisiones, puedes poner un weight a latest para que nuevos deployments reciban automáticamente ese tráfico. Esto simplifica el proceso CI/CD.

Usar revision labels para acceso directo

Revision labels proporcionan acceso directo a endpoints que llevan a esa revision, sin tener en cuenta el traffic splitting configurado.
Cada label crea una URL única que siempre enruta a esa labeled revision.

Las labels funcionan de manera independiente a traffic splitting

Esto se hace para poder testear revisions específicas sin afectar a la experiencia de usuario que hayamos configurado con traffic splitting.

Lo suyo es usar traffic splitting para rollouts graduales y labels para testing directo

Scaling con múltiples revisions

Si tenemos múltiples revisions activas, cada una escala de manera independiente basándose en sus propias scale rules y tráfico asignado.
Esto tiene implicaciones para el coste. Dos revisions que reciban 50% de tráfico cada una pueden costar juntas más que una única revision que maneje un 100%, ya que cada revision mantiene sus propias réplicas mínimas y escalan con sus propias métricas.

Usar Azure Monitor para revisar las réplicas durante traffic splitting.

Best practices

  • Usar single revision mode para deployments simples: ofrece zero-downtime deployments sin tener que configurar nada. Seleccionar esto a menos que necesites traffic splitting, canary releases u otras capacidades avanzadas
  • Usar multiple revision mode para canary releases: Usarlo cuando necesites rollouts progresivos
  • Desactivar revisions viejas: Las revisions activas escalan independientemente y consumen recursos. Cuando se ha migrado el tráfico y ya no se usan, desactivarlas para evitar consumo
  • Hacer testing con labels antes de traffic splitting: usar revision labels para validar nuevas revisiones antes de asignarles tráfico

Additional resources

Update and deploy changes in Azure Container Apps
Traffic splitting in Azure Container Apps
Blue-Green Deployment in Azure Container Apps