GitLab Runner es una herramienta desarrollada para permitir a los usuarios ejecutar trabajos de integración continua e implementación continua (CI/CD) para proyectos de GitLab. Funciona como un agente que ejecuta los comandos especificados en la configuración de GitLab CI/CD. Podemos instalar fácilmente GitLab Runner en su Ubuntu Linux para automatizar el proceso de prueba e implementación, lo que en última instancia nos facilita la administración y el mantenimiento de proyectos de software.
Vamos a ver como es la instalación para distribuciones Linux Debian/Ubuntu.
PASO 1: Instalar curl
Como pre-requisito es necesario estar actualizados y tener curl
sudo apt update && sudo apt -y upgrade && sudo apt install -y curl
PASO 2: Descarga e instalación
Vos a basarme en la documentación de: Gitlab
Primero que nada debemos saber la arquitectura de nuestro equipo
dpkg --print-architecture
Y descargamos el paquete reemplazando ${arch} por el resultado del comando anterior
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_${arch}.deb"
En mi caso:
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_amd64.deb"
Instalamos
dpkg -i gitlab-runner_amd64.deb
PASO 3: Configuración
Ahora deberemos responde una serie de preguntas al lanzar el comando de instalación, dejo en negrita lo que necesitamos, y nos pedirá un token de registración, esto lo obtenemos de la configuración del proyecto en: Settings > CD/CD > Runners > Expand, en Project runners copiamos el token para responderlo más abajo.
# gitlab-runner register Runtime platform arch=amd64 os=linux pid=1999 revision=853330f9 version=16.5.0 Running in system-mode. Enter the GitLab instance URL (for example, https://gitlab.com/): https://gitlab.com Enter the registration token: XXXXXXXXXXXXXXXXXX Enter a description for the runner: [nksist1]: test-1 Enter tags for the runner (comma-separated): localdocker, locallinux Enter optional maintenance note for the runner: WARNING: Support for registration tokens and runner parameters in the 'register' command has been deprecated in GitLab Runner 15.6 and will be replaced with support for authentication tokens. For more information, see https://docs.gitlab.com/ee/ci/runners/new_creation_workflow Registering runner... succeeded runner=XXXXXXXXXXXX Enter an executor: virtualbox, kubernetes, custom, parallels, shell, ssh, instance, docker, docker-windows, docker-autoscaler, docker+machine: shell Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded! Configuration (with the authentication token) was saved in "/etc/gitlab-runner/config.toml"
Como último paso hay que reiniciar el servicio
# gitlab-runner restart Runtime platform arch=amd64 os=linux pid=2232 revision=853330f9 version=16.5.0
PASO 4: verificación
Desde donde copiamos el token recargamos la página y ya podremos ver nuestra vm local lista para ser utilizada haciendo uso de las etiquetas.