Gitlab CI/CD es una herramienta de DevOps integrada en Gitlab para poder hacer integración continua, entrega continua y desarrollo continuo. Para poder utilizar esta herramienta se han de usar los Gitlab Runners, los cuales son unas aplicaciones que se encargan de ejecutar los trabajos de los pipelines de Gitlab CI/CD.
Aunque los servidores de Gitlab pueden tener Runners compartidos que puede utilizar cualquier usuario, nos puede interesar tener uno o más Runners en nuestra propia máquina. En este artículo explicaremos cómo puede hacerse de forma rápida y sencilla.
Instalación usando contenedores Docker
Existen múltiples maneras de instalar un Runner en una máquina, pero la forma más flexible y la que explicaremos en este artículo es utilizando contenedores Docker.
Los requisitos para poder instalar y utilizar un Runner con Docker son los siguientes:
- Tener una máquina con Docker instalado y entender su funcionamiento básico
- Tener un token de registro de Runners en un grupo o proyecto de Gitlab
Para obtener el token de registro únicamente hay que ir al grupo o proyecto donde queramos registrar Runner y acceder a «Settings -> CI/CD -> Runners«. Es importante que el token se mantenga en secreto, ya que utilizando este token cualquier persona puede registrar un Runner en su proyecto y potencialmente obtener acceso a los archivos. En caso de que se filtre, pulse el botón «Reset registration token» para obtener uno nuevo.
Una vez obtenido el token de registro hay que crear el contenedor que se encargará de ejecutar los Runners. Para ello hay que ejecutar los siguientes comandos con permisos de administrador:
docker volume create gitlab-runner-config
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v gitlab-runner-config:/etc/gitlab-runner \
gitlab/gitlab-runner:latest
El siguiente paso es registrar un Runner para que ejecute nuestras pipelines. Esto se puede hacer ejecutando el siguiente comando y suministrar los datos que pide:
docker run --rm -it -v gitlab-runner-config:/etc/gitlab-runner gitlab/gitlab-runner:latest register
Ya para terminar, hay que ir a Settings, CI/CD, Runners y mirar si el Runner aparece en la sección «Available specific runners».
Si aparece es que todo ha ido bien y ya lo podemos utilizar para ejecutar nuestras pipelines. En caso de que haga falta tener más Runners solamente hay que repetir el comando utilizado para registrar uno nuevo.