Laboratório: Pipeline CI/CD automatizado com GitLab Runner em ambiente local

Duração estimada

120 min

Passos

11

Validações

4

Versões da documentação consultada

GitLab Community Edition a versão estável atual · GitLab Runner a versão estável atual · Docker a versão estável atual · Git a versão estável atual

Topologia

Uma máquina virtual Linux (ex: Ubuntu 22.04, IP 192.168.56.10) roda GitLab Runner e um projeto local. O Runner se conecta à API de um servidor GitLab CE (Community Edition) rodando em outra VM (192.168.56.20). O pipeline é disparado por push via Git. O Runner executa jobs de build, teste e um deploy simulado (cópia de arquivos para /tmp/deploy). Comunicação apenas via rede privada.

┌──────────────┐       push/pull        ┌──────────────┐
│ Dev Machine  │ <-------------------> │  GitLab CE   │
│ (opcional)   │                      │192.168.56.20 │
└─────┬────────┘                      └─────┬────────┘
      │   CI/CD jobs (API)                  │
      │-------------------------------------│
      │                                     │
┌─────▼────────┐                      ┌─────▼────────┐
│ GitLab Runner│                      │  Projeto     │
│192.168.56.10 │                      │(repo local)  │
└──────────────┘                      └──────────────┘

Equipamentos e software

Roteiro

1. Preparar as VMs e instalar dependências

   Garanta que as duas VMs estejam na mesma rede privada. Atualize os pacotes e instale curl, Docker e Git nas duas VMs. O Docker é necessário para executar jobs isolados no Runner.

   sudo apt update && sudo apt install -y curl git docker.ioCopiar

   O que você deve ver: Pacotes instalados sem erros.

2. Instalar o GitLab CE na VM 192.168.56.20

   O GitLab CE será o servidor de repositórios e pipelines. Siga o guia oficial para instalar via pacote DEB.

   curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
   sudo EXTERNAL_URL="http://192.168.56.20" apt install gitlab-ceCopiar

   O que você deve ver: GitLab CE instalado e acessível via navegador em http://192.168.56.20

3. Configurar usuário e projeto no GitLab CE

   Crie um usuário admin e um projeto novo chamado 'demo-ci'. Isso permite versionar o pipeline e acionar builds.

   Acesse http://192.168.56.20, siga o onboarding para criar usuário admin, faça login e crie o projeto 'demo-ci'.Copiar

   O que você deve ver: Projeto 'demo-ci' criado e visível no dashboard.

4. Clonar o projeto demo-ci na VM do Runner

   O Runner precisa de um clone local do repositório para executar jobs. Clone usando SSH ou HTTP.

   git clone http://192.168.56.20/demo-ci.git
   cd demo-ciCopiar

   O que você deve ver: Repositório clonado e diretório 'demo-ci' criado.

5. Instalar o GitLab Runner na VM 192.168.56.10

   O Runner é o agente que executa os jobs do pipeline. Instale usando o script oficial.

   curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
   sudo apt install gitlab-runnerCopiar

   O que você deve ver: GitLab Runner instalado. Verifique com 'gitlab-runner --version'.

6. Registrar o Runner no GitLab CE

   O Runner precisa ser registrado para aceitar jobs desse projeto. Use o token do projeto em Settings > CI/CD > Runners.

   sudo gitlab-runner register
   # URL: http://192.168.56.20
   # Token: (copie do GitLab)
   # executor: docker
   # image: ubuntu:22.04Copiar

   O que você deve ver: Runner registrado e listado em Settings > CI/CD > Runners do projeto.

7. Criar o arquivo .gitlab-ci.yml

   Defina o pipeline com três stages: build, test, deploy. O deploy será uma cópia simulada.

   cat > .gitlab-ci.yml <<EOF
   stages:
     - build
     - test
     - deploy
   
   build_job:
     stage: build
     script:
       - echo "Compilando..."
       - mkdir build && echo 'hello' > build/app.txt
   
   test_job:
     stage: test
     script:
       - cat build/app.txt | grep hello
   
   deploy_job:
     stage: deploy
     script:
       - mkdir -p /tmp/deploy
       - cp build/app.txt /tmp/deploy/
   EOFCopiar

   O que você deve ver: Arquivo .gitlab-ci.yml criado no diretório do projeto.

8. Commit e push do pipeline para o GitLab CE

   Versione o pipeline e envie para o servidor. Isso dispara o pipeline automaticamente.

   git add .gitlab-ci.yml
   git commit -m "Adiciona pipeline CI/CD"
   git push origin mainCopiar

   O que você deve ver: Pipeline iniciado no GitLab CE. Veja em CI/CD > Pipelines.

9. Acompanhar a execução do pipeline

   No GitLab CE, monitore os jobs em tempo real. O Runner executa cada etapa via Docker.

   Acesse http://192.168.56.20/demo-ci/pipelinesCopiar

   O que você deve ver: Todos os jobs (build, test, deploy) executados com sucesso (status verde).

10. Verificar o resultado do deploy simulado

    Confirme que o arquivo foi copiado para /tmp/deploy na VM do Runner.

    ls -l /tmp/deploy/app.txtCopiar

    O que você deve ver: Arquivo app.txt presente em /tmp/deploy.

11. Testar alteração e re-executar pipeline

    Altere o conteúdo do app.txt, faça commit e push. O pipeline deve rodar novamente.

    echo 'hello upnetix' > build/app.txt
    git add build/app.txt
    git commit -m "Atualiza app.txt"
    git push origin mainCopiar

    O que você deve ver: Novo pipeline iniciado e concluído, novo conteúdo em /tmp/deploy/app.txt.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Não exponha o GitLab CE na internet sem HTTPS e autenticação forte
• Execute o Runner em usuário dedicado, nunca como root
• Limite permissões do diretório /tmp/deploy
• Remova tokens de registro após uso

Checklist final

• GitLab CE instalado e acessível
• Runner instalado e registrado
• .gitlab-ci.yml criado e versionado
• Pipeline executado com sucesso
• Deploy simulado realizado