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