O GitLab Runner é uma aplicação usada com o GitLab CI/CD para executar jobs em pipelines. Ele é essencial para automatizar testes, builds e deploys, aumentando a eficiência e a consistência dos processos de desenvolvimento. Este artigo aborda a instalação, configuração e utilização do GitLab Runner no ambiente Linux, que é uma das plataformas mais comuns para servidores e desenvolvimento.

Exemplos:

Passo 1: Instalação do GitLab Runner

Primeiro, vamos adicionar o repositório oficial do GitLab Runner e instalar o pacote:

# Adicionar o repositório GitLab Runner
curl -L --output /etc/apt/trusted.gpg.d/gitlab.asc https://packages.gitlab.com/gitlab/gitlab-runner/gpgkey
echo "deb https://packages.gitlab.com/gitlab/gitlab-runner/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab-runner.list

# Atualizar os pacotes e instalar o GitLab Runner
sudo apt-get update
sudo apt-get install gitlab-runner

Passo 2: Registro do GitLab Runner

Após a instalação, é necessário registrar o runner no GitLab. Para isso, você precisará do URL do GitLab e do token de registro, que podem ser encontrados na interface web do GitLab, em Settings > CI/CD > Runners.

sudo gitlab-runner register

Durante o processo de registro, você será solicitado a fornecer as seguintes informações:

• URL do GitLab: https://gitlab.com/ ou o URL do seu servidor GitLab.
• Token de registro: fornecido pelo GitLab.
• Descrição do Runner: uma descrição amigável para identificar o runner.
• Executor: escolha o executor adequado (shell, docker, etc.). Para este exemplo, usaremos shell.

Passo 3: Configuração do GitLab Runner

O arquivo de configuração do GitLab Runner está localizado em /etc/gitlab-runner/config.toml. Aqui você pode ajustar as configurações conforme necessário. Por exemplo, para configurar um runner que usa Docker, você pode adicionar:

[[runners]]
  name = "docker-runner"
  url = "https://gitlab.com/"
  token = "YOUR_TOKEN"
  executor = "docker"
  [runners.custom_build_dir]
  [runners.docker]
    tls_verify = false
    image = "alpine:latest"
    privileged = true
    disable_entrypoint_overwrite = false
    oom_kill_disable = false
    disable_cache = false
    volumes = ["/cache"]
    shm_size = 0
  [runners.cache]
    [runners.cache.s3]
    [runners.cache.gcs]

Passo 4: Iniciar e Gerenciar o GitLab Runner

Para iniciar o GitLab Runner, use o comando:

sudo gitlab-runner start

Você também pode verificar o status do runner e gerenciá-lo com os comandos:

sudo gitlab-runner status
sudo gitlab-runner stop
sudo gitlab-runner restart

Passo 5: Executar Jobs no GitLab

Com o runner registrado e configurado, você pode definir jobs no arquivo .gitlab-ci.yml do seu repositório GitLab. Um exemplo simples de pipeline que executa testes pode ser:

stages:
  - test

test_job:
  stage: test
  script:
    - echo "Running tests..."
    - ./run_tests.sh

Conclusão

O GitLab Runner é uma ferramenta poderosa para automação de CI/CD, e sua configuração no Linux é direta e eficiente. Com ele, você pode automatizar tarefas repetitivas, garantindo que seu código seja testado e implantado de maneira consistente.