← Volver al listado de tecnologías ← Índice de GitLab Runners

Instalacion y Registro

Por: Artiko
gitlabrunnersinstalacionregistro

Instalacion y Registro

Instalacion en Linux (Debian/Ubuntu)

# Agregar repositorio oficial
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash

# Instalar
sudo apt-get install gitlab-runner

Instalacion en Linux (RHEL/Fedora)

curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash
sudo yum install gitlab-runner

Instalacion con Docker

docker run -d \
  --name gitlab-runner \
  --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitlab/gitlab-runner:latest

Instalacion en macOS

brew install gitlab-runner
brew services start gitlab-runner

Registro del Runner

El registro conecta tu runner con una instancia de GitLab. Necesitas un token de registro.

Obtener el token

  1. Ve a Settings > CI/CD > Runners en tu proyecto o grupo
  2. Copia el registration token (proyectos) o usa New project runner (metodo nuevo)

Registro interactivo

sudo gitlab-runner register

Te pedira:

  1. URL de GitLab: https://gitlab.com/ o tu instancia
  2. Token de registro: El token copiado
  3. Descripcion: Nombre descriptivo del runner
  4. Tags: Etiquetas separadas por coma (ej: docker,linux)
  5. Executor: docker, shell, kubernetes, etc.

Registro no interactivo

sudo gitlab-runner register \
  --non-interactive \
  --url "https://gitlab.com/" \
  --token "glrt-xxxxxxxxxxxx" \
  --executor "docker" \
  --docker-image "alpine:latest" \
  --description "runner-docker-linux"

Registro con Runner Authentication Token (metodo nuevo)

Desde GitLab 16.0, se recomienda crear runners desde la UI y usar authentication tokens (glrt-):

sudo gitlab-runner register \
  --url "https://gitlab.com" \
  --token "glrt-xxxxxxxxxxxx"

Este metodo es mas seguro porque:

Verificar la instalacion

# Estado del servicio
sudo gitlab-runner status

# Listar runners registrados
sudo gitlab-runner list

# Verificar conexion con GitLab
sudo gitlab-runner verify

Desregistrar un Runner

# Por token
sudo gitlab-runner unregister --token "glrt-xxxxxxxxxxxx"

# Por nombre
sudo gitlab-runner unregister --name "runner-docker-linux"

# Todos
sudo gitlab-runner unregister --all-runners

Siguiente: Capitulo 3: Executors →

← Volver al listado de tecnologías ← Índice de GitLab Runners