GitLab Runner: Primeros pasos

Conecte su Stackhero GitLab Runner a GitLab.com, Stackhero for GitLab o a su propio servidor GitLab y ejecute su primer pipeline en cuestión de minutos

👋 ¡Bienvenido a la documentación de Stackhero!

Stackhero ofrece una solución sencilla de GitLab Runner en la nube que facilita la ejecución de sus trabajos de GitLab CI/CD de manera eficiente y sin complicaciones. Esto es lo que puede esperar:

• Minutos ilimitados de CI/CD: ejecute sus pipelines tantas veces como necesite, sin facturación por minuto ni cargos inesperados.
• Varios trabajos concurrentes: acelere su desarrollo ejecutando varios trabajos en paralelo.
• El ejecutor Docker con soporte para Docker-in-Docker: construya y publique fácilmente imágenes de contenedores como parte de su proceso CI/CD.
• Funciona perfectamente tanto con GitLab.com como con instancias de GitLab autogestionadas.
• Una infraestructura privada y dedicada con almacenamiento NVMe/SSD rápido garantiza un rendimiento de compilación estable y predecible.
• Disponible en las regiones de 🇪🇺 Europa y 🇺🇸 USA para adaptarse a las necesidades de su equipo.

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 que ejecuta sus trabajos de GitLab CI/CD. Cada vez que se ejecuta un pipeline, el runner recoge cada trabajo, lo ejecuta dentro de un contenedor Docker aislado y reporta los resultados de vuelta a GitLab.

Con Stackhero, su runner siempre se ejecuta sobre infraestructura privada y dedicada. No existen cargos por minuto ni cuotas de uso: sus minutos de CI/CD son ilimitados. Según su plan, su runner puede procesar varios trabajos concurrentes al mismo tiempo, por lo que escalar la capacidad de construcción es sencillo.

Esta guía le ayuda a conectar su runner de Stackhero a GitLab y a ejecutar su primer pipeline rápidamente.

Paso 1: Cree su GitLab Runner en Stackhero

Desde su panel de Stackhero, puede crear un nuevo servicio GitLab Runner y seleccionar el plan que mejor se adapte a su flujo de trabajo. El plan determina la CPU, la RAM disponibles y el número de trabajos concurrentes (que corresponde al parámetro concurrent de GitLab Runner: cuántos trabajos puede procesar el runner en paralelo).

Su runner estará listo para usar 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 y también se elige el alcance del runner:

• Runner de proyecto: Abra su proyecto y vaya a Settings > CI/CD > Runners > New project runner.
• Runner de grupo: Abra su grupo y vaya a Settings > CI/CD > Runners > New group runner.
• Runner de instancia (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 dirigir trabajos a este runner.
• Permitir que ejecute trabajos sin etiquetas si desea que procese todos los trabajos, incluso los que no tienen etiquetas.

GitLab le proporcionará un token de autenticación de runner que comienza por glrt-. Mantenga este token seguro, ya que su runner lo utiliza para autenticarse con GitLab.

El método anterior con el registration token está obsoleto. Utilice el token de autenticación de runner (glrt-...) creado al añadir el runner, como se describe arriba.

Puede encontrar más detalles en la documentación oficial de registro de runners de GitLab.

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:

• URL de GitLab: Utilice https://gitlab.com para GitLab.com, o la URL de su instancia autogestionada de GitLab. (Si está ejecutando GitLab en Stackhero, podría ser https://git.su-empresa.com.)
• Token de autenticación de runner (glrt-...) que obtuvo en el Paso 2.
• Número de trabajos concurrentes que desea permitir.

Después de guardar la configuración, su runner se conectará a GitLab y aparecerá como online en la página de Runners donde lo configuró.

Paso 4: Ejecute su primer pipeline

Añada un archivo .gitlab-ci.yml en la raíz de su repositorio para definir su pipeline:

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 lanzará 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

Sus pipelines ahora se ejecutan en su runner dedicado, con minutos de construcción ilimitados y sin límites de uso que gestionar.

Siguiente paso

Si desea construir y publicar imágenes Docker desde sus pipelines, puede continuar con Construcción de imágenes Docker.