Migrate from Autobuilds

Warning

Docker Hub Automated Builds is a deprecated feature. It will be fully retired on April 1, 2027.

Esta guía explica cómo migrar tu configuración de Docker Hub Autobuilds a flujos de trabajo de integración continua (CI), enfocándose en GitHub Actions y Bitbucket Pipelines, ya que son los servicios de CI integrados para los dos servicios de control de versiones compatibles a través de Autobuilds.

Paso 1: Crear tokens de acceso

Para otorgar a tus flujos de trabajo de CI la capacidad de descargar y subir imágenes a Docker Hub, primero debes crear tokens de acceso:

• Para un repositorio personal: Crea un token de acceso personal con permisos de Read & Write.

• Para un repositorio de organización: Crea un token de acceso de organización con los siguientes permisos:

  • Read public repositories
  • Image Pull en cualquier repositorio privado del que la compilación necesite descargar imágenes
  • Image Push en el repositorio al que se subirá la imagen compilada

Se puede usar el mismo token para todos los flujos de trabajo de CI bajo el espacio de nombres de la cuenta, siempre que tenga los permisos adecuados para todos los repositorios relevantes de Docker Hub.

Guarda el token de forma segura en un gestor de contraseñas o en el gestor de secretos de tu plataforma de CI/CD. Nunca confirmes (commit) tokens en los repositorios de código fuente.

Paso 2: Extraer tu configuración de Autobuilds

Para cada repositorio de Docker Hub configurado actualmente para usar Autobuilds, necesitas extraer su configuración para ajustar tus flujos de trabajo de CI y duplicar la funcionalidad existente. La única forma de extraer la configuración es a través de la interfaz web de Docker Hub.

1. Inicia sesión en Docker Hub.

2. Navega a tu repositorio yendo a My Hub > Tu espacio de nombres > Repositories > Tu repositorio.

3. Ve a la pestaña Builds y selecciona Configure automated builds.

   Si no hay una configuración de compilación existente, entonces este repositorio no está configurado para Autobuilds.

4. Toma nota de los siguientes detalles de configuración:

   • Source Repository: El repositorio de GitHub o Bitbucket. La organización es el espacio de nombres y el repositorio es el nombre del repositorio. Aquí es donde debes agregar tu flujo de trabajo.

   • Autotest: Si Autotest está habilitado para Pull Requests (ya sea solo interno o interno y externo), se necesitarán pasos adicionales en tu flujo de trabajo para ejecutar el paso de Autotest.

   • Repository Links: No es compatible y se puede ignorar. Si se requieren builds en cadena, consulta la documentación de tu servicio de CI sobre cómo encadenar builds.

   • Build Rules: Especifica los activadores, etiquetas y rutas de tus builds. Ignora cualquier entrada donde Autobuild esté desactivado.

   • Build Environment Variables: Variables definidas por el usuario que se insertan como variables de entorno en tu compilación. Debes agregarlas a tu flujo de trabajo. Si las variables de entorno contienen secretos, agrégalos al gestor de secretos de tu servicio de CI. Luego, actualiza tu Dockerfile o tus scripts de compilación para hacer referencia a estos secretos utilizando la sintaxis de tu plataforma de CI. Consulta la documentación de tu servicio de CI sobre cómo manejar secretos.

Ejemplo de configuración

La siguiente imagen muestra un ejemplo de configuración de Autobuilds.

Basándote en el ejemplo ilustrado, tomarías nota de los siguientes elementos para esta configuración de Autobuilds:

• Repositorio de código fuente: Repositorio de GitHub docker/docker-rust-hello
• Autotest: Deshabilitado
• Regla de compilación 1: Compila y sube la imagen con la etiqueta latest cuando se detecta un nuevo commit en la rama main. El Dockerfile está en ./Dockerfile y el contexto de compilación es la raíz del código clonado.
• Regla de compilación 2: Compila y sube la imagen con la etiqueta v{\1} cuando se detecta un nuevo commit en una etiqueta que coincide con la expresión regular ^v([0-9.]+)$. El Dockerfile está en ./Dockerfile y el contexto de compilación es la raíz del código clonado.
• Variable de entorno: Clave ENV_KEY con valor ENV_VALUE

Paso 3: Migrar a tu plataforma de CI/CD

Selecciona la pestaña que coincida con la plataforma de alojamiento de tu repositorio de código fuente.