Image tagging and versioning (Azure Container Registry)

Las diferentes estrategias de tagging afectan directamente al mantenimiento, deployment reliability, capacidades de rollback

Tagging strategies

Las tags son una manera humana de referenciar contenedores de imágenes.

Stable tags

Stable tags como latest, develop, v1, v1.2 se reutilizan entre múltiple image pushes y cuando se hace un overwrite de la tag, esta se quita de la imagen vieja y se pone en la nueva.

Es útil para las siguientes situaciones

  • security updates: si se hace un patch se actualiza automáticamente a la versión con el fix
  • Separar entornos: el entorno de DEV siempre contendrá la imagen develop
  • CI/CD: cuando el cliente deba tener siempre la última versión

La gran desventaja que tiene es la inconsistencia. Nodos diferentes pueden hacer un pull de la misma tag en momentos diferentes y recibir imágenes diferentes.

Unique tags

Las tags únicas como v.1.2.0-build456 no se reutilizan. Cada image push genera una nueva tag y se preservan todas las anteriores en el registry

Es útil para las siguientes situaciones

  • PROD deployments: cada nodo del cluster hace pull de la misma imagen
  • rollback: es fácil volver a una imagen determinada
  • auditorias y compliance: demuestra que imagen específica estaba desplegada durante un incidente

Semantic versioning

Semantic versioning sigue la nomenclatura MAJOR.MINOR.PATCH para comunicar la naturaleza del cambio

  • MAJOR: breaking changes que requieren que el consumidor haga actualizaciones (API changes; removed features)
  • MINOR: new features that are backward compatible
  • PATCH: bug fixes and security patches; sin cambios en la API
inference-api:1     # latest 1.x.x (stable tag)
inference-api:1.1   # latest 1.1.x (stable tag)
inference-api:1.1.0 # specific patch version (unique tag)

Los consumidores que apunten a inference-api:1 reciben automaticamente updates dentro de la v1. Los que referencien a inference-api:1.1.0 se mantienen en ese patch específico

Manage latest tag

latest es problemática y NO se debe usar en entornos de PROD por lo variable y volátil que es.

Si no se especifica una tag, Docker usa latest by default

Para entornos PROD especificar siempre una tag explícitamente

image: myregistry.azurecr.io/inference-api:v1.2.0

Lock deployed images

ACR permite bloquear imagenes para prevenir modificaciones o borrados accidentales.

Se suele usar lock para las imagenes de PROD o que sirven usuario reales

# como hacer lock de una imagen
az acr repository update \
	--name myregistry \
	--image inference-api:v1.2.0 \
	--write-enabled false

Las imágenes bloqueadas

  • No se pueden borrar
  • No se pueden hacer overwrite
  • Sobreviven las retention policies
  • Se mantienen siempre disponibles

Clean up imagenes sin tags

Cuando haces push de una imagen nueva con una tag que ya existe, a la imagen anterior se le quita esa tag. Estas imágenes huérfanas consumen recursos y se pueden acumular

Auto-purge

El comando acr purge permite limpiar y borrar imágenes. Se le pueden pasar filtros para indicar cuáles se deben borrar.

# borra imágenes más viejas de 30 dias y usa un regex para el filtro de nombre
az acr run --registry myregistry \
	--cmd "acr purge --filter 'inference-api:.*' --untagged --ago 30d" \
	/dev/null

Schedule automatic cleanup

Podemos crear una task que ejecute un cleanup automático. Esto asegura la consistencia vs ejecutar un purge manual

# se ejecuta cada vez y borra imagenes más viejas de 7 dias para todos los repos
az acr task create \
	--registry myregistry \
	--name cleanup-untagged \
	--cmd "acr purge --filter '.*:.*' --untagged --ago 7d" \
	--schedule "0 0 * * 0" \
	--context /dev/null

Retention policies

para Premium tiers

Se pueden configurar retention policies a nivel de registro que automaticamente eliminan untagged manifiestos después de un número de días.

Best practices

  • usar tags únicas para PROD: previene sorpresas desagradables cuando se hace update de las imágenes
  • reservar stable tags para base images: permite actualizar automáticamente cuando haya updates de seguridad
  • lock PROD images: previene borrados accidentales
  • implementar retention policies: limpia automáticamente el storage
  • incluir build metadata: añade información de traceabilidad a las tags para debug y audits. Linkea imagenes a las builds y source commits.
  • documentar la estructura usad para tagging: asegurate que todo el equipo trabaja de la misma manera

Additional resources

Image Tag Best Practices - Azure Container Registry
Lock Images to Prevent Deletion in Azure Container Registry - Azure Container Registry
Purge Tags and Manifests in Azure Container Registry - Azure Container Registry