GitLab Runner: Primeros pasos

Conecte su Stackhero GitLab Runner a GitLab.com o a una instancia autogestionada de GitLab y ejecute su primer pipeline

👋 ¡Bienvenido a la documentación de Stackhero!

Stackhero le ofrece una solución GitLab Runner cloud fácil de usar, diseñada para gestionar sus trabajos de GitLab CI/CD de manera eficiente. Esto es lo que puede esperar:

Minutos CI/CD ilimitados: no hay facturación por minuto, así que sus pipelines pueden ejecutarse siempre que lo necesite.

Múltiples trabajos concurrentes: ejecute varios trabajos al mismo tiempo para acelerar todo su pipeline.

Docker executor con soporte para Docker-in-Docker: simplifique la construcción y el push de sus imágenes de contenedor.

Compatible con GitLab.com y cualquier instancia GitLab autogestionada.

Una VM privada y dedicada impulsada por discos NVMe/SSD rápidos para builds consistentes y fiables.

Disponible en las regiones de 🇪🇺 Europa y 🇺🇸 USA.

Ahorre tiempo: puede conectar su primer GitLab Runner y empezar a ejecutar pipelines en solo unos minutos.

Introducción

Un GitLab Runner es el agente responsable de ejecutar sus trabajos CI/CD de GitLab. Cada vez que se activa un pipeline, el runner recoge cada trabajo, lo ejecuta dentro de un contenedor Docker limpio y luego informa de los resultados a GitLab.

Con Stackhero, su runner funciona en una máquina virtual privada y dedicada. No hay cargos por minuto ni cuotas de uso, y sus minutos de CI/CD son ilimitados. Dependiendo de su plan, su runner puede gestionar docenas de trabajos concurrentes al mismo tiempo.

Esta guía le explica cómo conectar su runner de Stackhero a GitLab en solo unos minutos.

Paso 1: Cree su GitLab Runner en Stackhero

Desde su panel de Stackhero, puede crear un nuevo servicio GitLab Runner y elegir el plan que mejor se adapte a sus necesidades. El plan determina la CPU, la RAM disponible y el número de trabajos concurrentes (que corresponde al parámetro concurrent de GitLab Runner, es decir, el número de trabajos que pueden ejecutarse simultáneamente).

Su runner estará listo y operativo en unos 2 minutos.

Paso 2: Cree un runner en GitLab

Su runner se conecta a GitLab utilizando un token de autenticación de runner. Este token se genera en GitLab, donde también decide el alcance del runner:

Project runner: Abra su proyecto y vaya a Settings > CI/CD > Runners > New project runner.
Group runner: Abra su grupo y vaya a Settings > CI/CD > Runners > New group runner.
Instance runner (solo para GitLab autogestionado): Vaya a Admin area > CI/CD > Runners > New instance runner.

Al crear el runner, puede:

Añadir etiquetas (como docker o stackhero) para poder dirigir trabajos a este runner desde sus pipelines.
Permitir que ejecute trabajos sin etiqueta si quiere que recoja todos los trabajos.

GitLab le proporcionará un token de autenticación de runner que comienza por glrt-. Asegúrese de mantener este token seguro, ya que es lo que utiliza su runner para autenticarse.

El antiguo flujo con registration token está obsoleto. Utilice el token de autenticación de runner (glrt-...) creado junto con el runner, como se describe arriba.

Paso 3: Conecte su runner

Vuelva a su panel de Stackhero, abra la configuración de su servicio GitLab Runner e introduzca los siguientes datos:

Su URL de GitLab: Utilice https://gitlab.com para GitLab.com, o la URL de su instancia autogestionada de GitLab (por ejemplo, si ejecuta GitLab en Stackhero, podría ser https://git.su-empresa.com).
El token de autenticación de runner (glrt-...) que obtuvo en el Paso 2.
El número de trabajos concurrentes que desea permitir.

Una vez que guarde la configuración, su runner se conectará automáticamente a GitLab y aparecerá como online en la página Runners donde lo creó.

Paso 4: Ejecute su primer pipeline

Para comenzar, añada un archivo .gitlab-ci.yml en la raíz de su repositorio:

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

Haga commit y push de sus cambios. GitLab iniciará un pipeline y su runner de Stackhero ejecutará los trabajos. Si añadió etiquetas al crear el runner, puede dirigirse a ellas en sus trabajos de la siguiente manera:

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

Eso es todo. Sus pipelines ahora se ejecutan en su propio runner dedicado, con minutos de build ilimitados.

Siguiente paso

¿Le interesa construir y publicar imágenes Docker desde sus pipelines? Puede continuar con Construir imágenes Docker.