Probado en:
|
Runner GitLab
En GitLab, un runner es una instancia que se encarga de ejecutar las tareas dentro de los pipelines de CI/CD configurados en un proyecto. Los runners son fundamentales para realizar acciones como la compilación, pruebas automatizadas y el despliegue de software. Cada runner puede configurarse para operar en un proyecto en particular o estar disponible para varios proyectos dentro de un grupo. En resumen, los runners son componentes cruciales en GitLab que permiten automatizar los procesos de desarrollo y entrega de software. A continuación, se presenta una guía para la creación y configuración de un runner.
Esta guía de instalación y configuración del runner se realizó en la versión v17 de GitLab en Debian 12.
Instalación de runner
Paso 1: actualizar sistema
sudo apt update
Paso 2: Instalar dependencias
sudo apt-get install -y curl wget gnupg
Paso 3: Agrega la clave GPG del repositorio oficial de GitLab
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
Paso 4: Instalar GitLab Runner
Instalar GitLab Runner
Creación y configuración de runner
Paso 1
Para crear un runner debemos acceder en la plataforma de GitLab al proyecto donde queremos crearlo, en la columna izquierda de la plataforma debemos localizar la sección que se muestra en la fig .1 en este caso la ruta sería settings->CI/CD.
Fig 1 Ruta para las herramientas de CI/CD en GitLab
Paso 2
Al acceder al área de </strong>CI/CD de GitLab nos vamos a la sección de runners dar clic en “Expand” fig 2
Fig 2 Sección de runners.
Al dar click en “Expand” nos mostrará la siguiente pantalla fig 3, al dar clic en “New project runner” aparecerá una pantalla que se muestra en la fig 4 en donde puedes configurar diversos parámetros para que el runner funcione adecuadamente.
Fig 3 Pantalla de runners.
Paso 3
Fig 4 Configuración del runner.
Para crear el runner basta con elegir el tipo de sistema operativo y asignar el nombre con el que identificamos al runner, una vez asignados estos parámetros dar clic en create runner en la pantalla mostrada en la fig 4 al realizar esto nos lanzará la pantalla mostrada en la fig 5 en donde se nos darán instrucciones de los comandos que debemos escribir en la terminal de la máquina donde se esté configurando el runner.
Paso 4
Fig 5 Instrucciones de configuración de runner
Paso 5
Como se mencionó anteriormente, en la pantalla de la fig 5 se muestran los pasos a seguir para concluir la configuración como primer paso se tiene que abrir una terminal en la máquina que se va a configurar el runner y escribir el siguiente comando.
sudo gitlab-runner register
Al dar enter te irán solicitando los siguientes parámetros:
Fig6 Configuración runner
la pantalla mostrada en la fig 6 muestra el proceso que va siguiendo el proceso del runner como sigue:
1- Enter the GitLab instance URL (for example, https://gitlab.com/):
colocar la url que el mismo GitLab te da mostrado en la fig 5 dar enter
2- Enter the registration token:
colocar el token del runner igual se toma el que aparece en la fig 5 dar enter
3- Enter a name for the runner. This is stored only in the local config.toml file:
colocar el mismo nombre que se colocó en la sección tag al momento de crear el runner en GitLab ver fig 4
4- Enter an executor: parallels, docker+machine, kubernetes, docker-autoscaler, instance, ssh, shell, virtualbox, docker, docker-windows, custom:
En esta sección se le indica al runner cómo va a ejecutar las tareas el pipeline el más común es usar Shell aunque dependerá de la actividad que va a realizar el runner.
al dar enter nuevamente terminará de configurar los parámetros del runner.
Finalmente, al terminar de registrar todos los datos habrá que copiar la configuración del runner a la carpeta etc (esto no se especifica en el proceso que te ofrece GitLab sin embargo si no se realiza no se activa el runner.
sudo cp /home/usuario/.gitlab-runner/config.toml /etc/gitlab-runner/
Nota: reemplaza ‘usuario’ con el nombre de usuario que utilizas en tu máquina. Por ejemplo, si tu nombre de usuario es ‘juan’, el comando sería:
sudo cp /home/juan/.gitlab-runner/config.toml /etc/gitlab-runner/
Después recargamos el runner
sudo gitlab-runner restart
Posteriormente ya podemos dar clic en Go to runners page de la pantalla mostrada en la fig 5 y veremos el runner con un círculo verde que indica que se ha configurado correctamente como se ve en la fig 7.
Fig 7 Runner creado correctamente.
Enlaces Útiles
Para más información, consulta la documentación oficial de GitLab:
}https://docs.gitlab.com/runner/install/
Conclusión
Instalar y configurar un runner en GitLab es esencial para proyectos que buscan automatizar el ciclo de integración y entrega continua (CI/CD). Con un runner, puedes ejecutar pruebas, compilaciones y despliegues de forma automática, lo cual mejora la eficiencia, reduce el tiempo de lanzamiento y minimiza errores en los procesos.
