Configuración de builds automatizados en Docker Hub

En esta entrada os cuento cómo configurar builds automatizados en Docker Hub. Esto os permitirá que las imágenes Docker se construyan automáticamente cada vez que hagáis un cambio en el código fuente utilizado para construir la imagen y subáis ese cambio al repositorio de GitHub o de Bitbucket que estéis utilizando para alojar ese código.

¿Qué es Docker Hub?

Docker Hub es el registro online de imágenes Docker proporcionado por Docker Inc., la compañía que está detrás del desarrollo de Docker.

Docker Hub proporciona repositorios gratuitos para imágenes públicas, o bien se puede pagar para disponer de repositorios privados.

Subir imágenes a Docker Hub

Si queréis subir vuestras imágenes Docker a Docker Hub, lo primero que tenéis que hacer es crearos una cuenta en https://hub.docker.com.

Una vez que dispongáis de una cuenta, subir una imagen Docker a Docker Hub es tan sencillo como ejecutar un comando docker push similar al siguiente:

En este caso estoy subiendo la imagen con Jenkins que construí en la entrada Instalación de Jenkins con Docker.

En vuestro caso, sólo tendréis que cambiar el nombre de la cuenta aprenderdevops por el de vuestra cuenta de Docker Hub, y el nombre del repositorio de imágenes, en este caso jenkins, por el nombre que le queráis dar a vuestra imagen.

Además, tenéis la opción de indicar la etiqueta o tag de la imagen. En el ejemplo he utilizado latest, que convencionalmente se suele utilizar para hacer referencia a la última imagen construida, y por lo tanto la más actual.

Una vez subida la imagen Docker a Docker Hub, esta estará disponible públicamente y cualquiera podrá descargarla para que esté disponible localmente. Para ello, únicamente tendrá que ejecutar un comando docker pull similar al siguiente:

Configurar builds automatizados en Docker Hub

Si accedéis al sitio web de Docker Hub, encontraréis vuestro repositorio en una URL similar a https://hub.docker.com/r/aprenderdevops/jenkins/.

Iniciando sesión en Docker Hub podréis realizar algunas tareas de administración como establecer una descripción para el repositorio, establecer otros usuarios como colaboradores o configurar webhooks.

Para que vuestras imágenes Docker se actualicen cada vez que vuestro código fuente cambie, podéis configurar en Docker Hub los builds automatizados. Esto hará que cada vez que subáis a GitHub o Bitbucket cambios en el código fuente, Docker Hub construya de forma totalmente automática una nueva versión de la imagen Docker y la guarde en vuestro repositorio de Docker Hub.

Los builds automatizados se configuran en el interfaz web de Docker Hub. Si habéis iniciado sesión en Docker Hub, veréis un menú desplegable en la parte superior de la pantalla con el nombre “Create”. En este menú debéis seleccionar la opción “Create Automated Build”, lo que os dirigirá a una nueva pantalla en la que deberéis enlazar vuestra cuenta de Docker Hub con una cuenta de GitHub o de Bitbucket.

Enlazar cuentas

En la nueva pantalla debéis pulsar en el botón “Link Accounts”.

El siguiente paso será elegir qué tipo de repositorio queréis enlazar con la cuenta de Docker Hub. Las opciones son GitHub o Bitbucket. En mi caso he elegido GitHub.

En el caso de GitHub, os pedirá que elijáis el tipo de acceso que vais a permitir desde Docker Hub a vuestra cuenta de GitHub. Lo más sencillo es elegir la opción recomendada (acceso de lectura y escritura a repositorios públicos y privados).

Una vez seleccionado el tipo de acceso, os solicitará que accedáis a la cuenta de GitHub que queréis enlazar.

Una vez logados, debéis autorizar a Docker Hub el acceso a vuestra cuenta de GitHub pulsando en el botón “Authorize docker”.

Si todo ha ido bien, os mostrará una pantalla similar a la siguiente, en la que se muestran las cuentas enlazadas con Docker Hub.

Configurar builds automatizados

Una vez enlazada la cuenta de Docker Hub con la cuenta de GitHub, podéis configurar builds automatizados. Para ello, volvéis a pulsar en el menú desplegable “Create” y seleccionáis la opción “Create Automated Build”, lo que os dirigirá a una nueva pantalla en la que ya os aparecerá la cuenta de GitHub que tenéis enlazada.

En la nueva pantalla debéis elegir la opción de GitHub.

Al seleccionar la opción de GitHub os dirigirá a una nueva pantalla en la que debéis seleccionar el repositorio de GitHub que contiene el código fuente, principalmente el Dockerfile, que se utilizará para construir la imagen Docker.

Una vez seleccionado el repositorio de GitHub con el código fuente de la imagen, el último paso es crear el build automatizado en una pantalla similar a la siguiente.

En esta pantalla tendréis que incluir una breve descripción del build automatizado.

La configuración por defecto asigna a la imagen la etiqueta latest si el build es disparado por un cambio realizado en la rama master del repositorio de GitHub. Adicionalmente, si el build es disparado por un cambio en otra rama del repositorio de GitHub distinta de la rama master, asignará a la imagen una etiqueta que tendrá el mismo nombre que la rama modificada.

Para crear el build automatizado, lo único que queda por hacer es pulsar el botón “Create” en la parte inferior derecha de la pantalla.

Probar los builds automatizados

Una vez configurado el build automatizado, cualquier cambio que subáis al repositorio de GitHub desencadenará de forma automática la construcción de una nueva versión de la imagen en Docker Hub, tal y como puede verse en la siguiente imagen.

Para conocer los detalles de un build concreto, tanto si ha sido satisfactorio como si ha fallado por algún error, sólo tenéis que pulsar sobre él. Esto os abrirá una nueva pantalla como la siguiente, en la que podréis ver el fichero README del repositorio de GitHub, el fichero Dockerfile y los logs del build.

A partir de ahora, cada vez que hagáis un cambio en el código fuente y lo subáis al repositorio de GitHub se desencadenará en Docker Hub la construcción de una nueva versión de la imagen Docker.