GitLab Runner: Primeiros passos

Ligue o seu Stackhero GitLab Runner ao GitLab.com, Stackhero for GitLab ou ao seu próprio servidor GitLab e execute o seu primeiro pipeline em poucos minutos

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

A Stackhero disponibiliza uma solução GitLab Runner cloud simples que torna a execução dos seus jobs GitLab CI/CD eficiente e sem complicações. Eis o que pode esperar:

• Minutos CI/CD ilimitados: execute os seus pipelines sempre que precisar, sem cobrança por minuto nem custos inesperados.
• Vários jobs em simultâneo: acelere o desenvolvimento ao executar múltiplos jobs em paralelo.
• O executor Docker com suporte para Docker-in-Docker: construa e faça push de imagens de containers facilmente como parte do seu processo CI/CD.
• Compatível tanto com GitLab.com como com instâncias GitLab self-managed.
• Uma infraestrutura privada e dedicada com armazenamento NVMe/SSD rápido garante um desempenho de build estável e previsível.
• Disponível nas regiões 🇪🇺 Europa e 🇺🇸 USA para responder às necessidades da sua equipa.

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 do GitLab. Sempre que um pipeline é executado, o runner recolhe cada job, executa-o dentro de um contentor Docker isolado e reporta os resultados de volta ao GitLab.

Com a Stackhero, o seu runner funciona sempre numa infraestrutura privada e dedicada. Não existem custos por minuto nem quotas de utilização: os seus minutos de CI/CD são ilimitados. Dependendo do seu plano, o runner pode processar vários jobs em simultâneo, facilitando o aumento da capacidade de builds.

Este guia ajuda-o a ligar o seu runner Stackhero ao GitLab e a executar rapidamente o seu primeiro pipeline.

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 mais adequado ao seu workflow. O plano define os recursos de CPU, RAM e o número de jobs em simultâneo (correspondente à configuração concurrent do GitLab Runner: quantos jobs o runner pode processar em paralelo).

O seu runner estará pronto a utilizar em cerca de 2 minutos.

Passo 2: Criar um runner no GitLab

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

• Runner de projeto: Abra o seu projeto e vá a Settings > CI/CD > Runners > New project runner.
• Runner de grupo: Abra o seu grupo e vá a Settings > CI/CD > Runners > New group runner.
• Runner de instância (apenas para GitLab self-managed): Vá a Admin area > CI/CD > Runners > New instance runner.

Ao criar o runner, pode:

• Adicionar tags (como docker ou stackhero) para direcionar este runner a partir dos seus jobs.
• Permitir que execute jobs sem tags caso pretenda que processe todos os jobs, mesmo os que não têm tags.

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 se autenticar junto do GitLab.

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

Pode encontrar mais detalhes na documentação oficial de registo de runners do GitLab.

Passo 3: Ligar o seu runner

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

• URL do GitLab: Utilize https://gitlab.com para o GitLab.com, ou o URL da sua instância GitLab self-managed. (Se estiver a utilizar o GitLab na Stackhero, poderá ser https://git.sua-empresa.com.)
• Token de autenticação do runner (glrt-...) obtido no Passo 2.
• Número de jobs em simultâneo que pretende permitir.

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

Passo 4: Execute o seu primeiro pipeline

Adicione um ficheiro .gitlab-ci.yml na raiz do seu repositório para definir o seu 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

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

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

Os seus pipelines passam agora a correr no seu runner dedicado, com minutos de build ilimitados e sem limites de utilização para gerir.

Próximo passo

Se pretende construir e enviar imagens Docker a partir dos seus pipelines, continue para Construir imagens Docker.