Build and run images (ACR Tasks)

ACR Tasks permite descargar sobre Azure la responsabilidad de hacer build de container images sin requerir una instalación local de Docker. Esto soluciona el problema de builds inconsistentes entre ordenadores diferentes.

En vez de hacer build local de imágenes y hacer push al registry, envías tu código a ACR y dejas que Azure se encargue del build process. Esto nos otorga:

  • Builds consistentes: sin problemas de “en mi ordenador funciona”
  • Sin necesitar tener Docker instalado localmente
  • CI/CD integration: se puede hacer trigger al hacer push de un commit, mediante cronjobs, etc.
  • Soporte multi-plataforma: soporta Linux, Windows y ARM

Quick tasks

Las Quick tasks son la manera más rápida de hacer build y push de una sola container image.

Quick tasks son ideales cuando necesitas hacer una build de manera inmediata o para una única vez y no necesitas persistencia

El comando az acr build envía el source code a ACR, hace build de la imagen en el cloud y hace push al registry. Es similar docker build y docker push pero en Azure

# el . final indica que el directorio sobre el que se ejecuta es el actual
az acr build \ 
	--registry myregistry \
	--image inference-api:v1.0.0 \
	.

El mismo comando acepta varios contextos de donde obtener el código

  • local directory
  • git repository
  • remote tarball: archivos comprimidos en un server remoto accesible mediante URL
# ejemplo haciendo retrieve de un github repository
az acr build \
	--registry myregistry \
	--image inference-api:v1.0.0 \
	https://github.com/myorg/inference-api.git

Automatically triggered tasks

ACR soporta CI/CD

Source code triggers

Se inicia cuando se hace push de un commit o se mergea una PR en GitHub (o Azure DevOps).

La parte `` asegura una tag única para cada build usando el ID de ACR task run

El personal access token (PAT) da acceso a ACR a tus repositorios privados y permite crear webhooks

az acr task create \
	--registry myregistry \
	--name build-inference-api \
	--image inference-api: \
	--context https://github.com/myorg/inference-api.git#main \
	--file Dockerfile \
	--git-access-token $PAT

Base image triggers

Hacen rebuild de una application image cuando su base image se updatea. Esto es crítico para aplicaciones de IA que dependen de imágenes base de ML frameworks, CUDA drivers, u otros componentes críticos.

Cuando haces update de una imagen base como python:3.11, ACR detecta el cambio y hace rebuild de todas las imágenes que deriven de esa o la usen con un FROM en su Dockerfile.

Este tipo de trigger sirve para asegurar que tu aplicación recibe parches de seguridad automáticamente sin intervención manual

Base image triggers funciona para base images en el mismo ACR registry u otros repositorios públicos. Para base images de repos privados, ambos la imagen base y la imagen de la aplicación tienen que estar en el mismo registry para que funcione

Scheduled triggers

Scheduled triggers se ejecutan de manera definida mediante cronjobs.

Multi-step tasks

Multi-step tasks extienden las quick tasks mediante workflows secuenciales definidos en YAML. Cada paso puede hacer build images, run containers, execute commands o tener dependencias entre pasos.

Multi-step tasks permiten tener workflows build-test-push enteramente dentro de ACR

esta task hace build de la imagen, hace push al registry y ejecuta el container para ejecutar tests. Si los tests fallan, te enteras antes de que la imagen se use para hacer deployment

version: v1.1.0
steps:
  - build: -t /inference-api: .
  - push:
    - /inference-api:
  - cmd: /inference-api: python -m pytest tests/

crear la task para el YAML

az acr task create \
	--registry myregistry \ 
	--name build-test-push \
	--context https://github.com/myorg/inference-api.git \
	--file acr-task.yaml \
	--git-access-token $PAT

Run a container image for testing

ACR Tasks pueden ejecutar una imagen ya construida para validar que funciona correctamente.

Esto permite pillar errores de configuración antes del deployment

# /dev/null indican que no hace falta source files ya que ejecutamos sobre una imagen existente
az acr run --registry myregistry \
	--cmd 'inference-api:v1.0.0 --python --version' \
	/dev/null

Best practices for ACR Tasks

  • usar variables para tags: Usar {{.Run.ID}} o {{.Run.Date}} en las tags para tener tags únicas y traceables a sus task run
  • secure access token: guardar los tokens personales en Azure Key Vault. No meterlos en repos ni incluirlos en scripts
  • monitor task logs: review task outputs para ver fallos de build mediante az acr task logs
  • optimizar build context: Ignorar ficheros innecesarios mediante .dockerignore
  • layer caching: ACR Tasks hace caching de layers entre builds. Revisa el orden de tus Dockerfiles instructions para maximizar cache hits y pon las instrucciones que más suelen cambiar en la parte final del fichero.

Additional resources

Automate Container Builds with Azure Container Registry Tasks - Azure Container Registry
Tutorial - Quick Docker Image Build with Azure ACR Tasks - Azure Container Registry
Multi-Step Task to Build, Test & Patch Image - Azure Container Registry