GitLab Runner: Primeiros passos

Ligue o seu Stackhero GitLab Runner ao GitLab.com ou a um GitLab autogerido e execute o seu primeiro pipeline

👋 Bem-vindo à documentação da Stackhero!

A Stackhero oferece-lhe uma solução GitLab Runner cloud fácil de utilizar, concebida para executar os seus jobs GitLab CI/CD de forma eficiente. Eis o que pode esperar:

Minutos CI/CD ilimitados: não existe faturação por minuto, por isso os seus pipelines podem correr sempre que precisar.

Vários jobs em simultâneo: execute vários jobs ao mesmo tempo para acelerar todo o seu pipeline.

Docker executor com suporte para Docker-in-Docker: simplifique a criação e o envio das suas imagens de containers.

Compatível com GitLab.com e também com qualquer instância GitLab self-managed.

Uma VM privada e dedicada alimentada por discos NVMe/SSD rápidos para builds consistentes e fiáveis.

Disponível nas regiões 🇪🇺 Europa e 🇺🇸 USA.

Poupe tempo: pode ligar o seu primeiro GitLab Runner e começar a executar pipelines em apenas alguns minutos!

Introdução

Um GitLab Runner é o agente responsável por executar os seus jobs de CI/CD no GitLab. Sempre que um pipeline é acionado, o runner recolhe cada job, executa-o dentro de um container Docker limpo e, em seguida, reporta os resultados de volta ao GitLab.

Com a Stackhero, o seu runner funciona numa VM privada e dedicada. Não existem custos por minuto nem quotas de utilização, e os seus minutos de CI/CD são ilimitados. Dependendo do seu plano, o runner pode processar dezenas de jobs em simultâneo.

Este guia explica como ligar o seu runner Stackhero ao GitLab em apenas alguns minutos.

Passo 1: Criar o seu GitLab Runner na Stackhero

A partir do seu dashboard Stackhero, pode criar um novo serviço GitLab Runner e escolher o plano que melhor se adapta às suas necessidades. O plano determina os recursos de CPU, RAM disponíveis e o número de jobs em simultâneo (correspondente à configuração concurrent do GitLab Runner, ou seja, o número de jobs que podem ser executados ao mesmo tempo).

O seu runner estará operacional em cerca de 2 minutos.

Passo 2: Criar um runner no GitLab

O seu runner liga-se ao GitLab utilizando um token de autenticação do runner. Este token é gerado no GitLab, onde também define o âmbito do runner:

Project runner: Abra o seu projeto e vá a Settings > CI/CD > Runners > New project runner.
Group runner: Abra o seu grupo e vá a Settings > CI/CD > Runners > New group runner.
Instance runner (apenas para GitLab autogerido): Vá a Admin area > CI/CD > Runners > New instance runner.

Ao criar o runner, pode:

Adicionar tags (como docker ou stackhero) para facilitar a seleção deste runner nos seus jobs.
Permitir que execute jobs sem tags caso pretenda que processe todos os jobs.

O GitLab irá fornecer-lhe um token de autenticação do runner que começa por glrt-. Guarde este token em segurança, pois é utilizado pelo runner para autenticação.

O método antigo com o registration token está descontinuado. Utilize o token de autenticação do runner (glrt-...) criado juntamente com o runner, conforme descrito acima.

Passo 3: Ligar o seu runner

Volte ao seu dashboard Stackhero, abra a configuração do serviço GitLab Runner e introduza os seguintes dados:

O seu URL do GitLab: Utilize https://gitlab.com para o GitLab.com, ou o URL da sua instância GitLab autogerida (por exemplo, se estiver a utilizar GitLab na Stackhero, poderá ser https://git.sua-empresa.com).
O token de autenticação do runner (glrt-...) obtido no Passo 2.
O número de jobs em simultâneo que pretende permitir.

Depois de guardar a configuração, o seu runner irá ligar-se automaticamente ao GitLab e aparecer como online na página Runners onde foi criado.

Passo 4: Execute o seu primeiro pipeline

Para começar, adicione um ficheiro .gitlab-ci.yml na raiz do seu repositório:

stages:
  - build
  - test

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

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

Faça commit e push das suas alterações. O GitLab irá iniciar um pipeline e o seu runner Stackhero irá executar os jobs. Se adicionou tags ao criar o runner, pode direcioná-las nos seus jobs da seguinte forma:

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

E está feito. Os seus pipelines passam a correr no seu runner dedicado, com minutos de build ilimitados.

Próximo passo

Pretende construir e publicar imagens Docker a partir dos seus pipelines? Continue para Construir imagens Docker.