wils@web ~ $ cat ~/ajuda/como-configurar-um-pipeline-ci-cd-com-gitlab-ci-e-docker-no-ubuntu-22-04.md

DevOps

Como configurar um pipeline CI/CD com GitLab CI e Docker no Ubuntu 22.04

atualizado em 24/07/2026

Este manual fornece um guia passo a passo sobre como configurar um pipeline CI/CD utilizando GitLab CI e Docker em um servidor Ubuntu 22.04.

Introdução

O GitLab CI é uma ferramenta poderosa para automação de integração e entrega contínua, enquanto o Docker permite criar, implantar e executar aplicações em contêineres. Juntos, eles facilitam o desenvolvimento e a entrega de software.

Pré-requisitos

  • Servidor Ubuntu 22.04 atualizado.
  • GitLab Runner instalado.
  • Docker instalado e funcionando.

Passo a Passo

1. Instalar o Docker

Execute os seguintes comandos para instalar o Docker:

sudo apt update
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

2. Adicionar seu usuário ao grupo Docker

Isso permite que você execute comandos Docker sem sudo:

sudo usermod -aG docker $USER

Após executar este comando, faça logout e login novamente.

3. Instalar o GitLab Runner

Use o seguinte comando para instalar o GitLab Runner:

sudo apt install -y gitlab-runner

4. Registrar o GitLab Runner

Execute o comando abaixo e siga as instruções para registrar o runner:

sudo gitlab-runner register
  • URL do GitLab: https://gitlab.com/
  • Token do projeto: disponível nas configurações do projeto no GitLab.
  • Descrição do runner: escolha um nome.
  • Tags: adicione tags se necessário.
  • Executor: escolha docker.

5. Criar um arquivo .gitlab-ci.yml

No diretório do seu projeto, crie um arquivo chamado .gitlab-ci.yml com o seguinte conteúdo:

image: docker:latest

services:
  - docker:dind

stages:
  - build

build:
  stage: build
  script:
    - docker build -t my-image:latest .
    - docker push my-image:latest

Conclusão

Após seguir esses passos, seu pipeline CI/CD estará configurado. A cada push no repositório, o GitLab CI executará o pipeline definido. Uma dica importante é monitorar os logs do GitLab Runner para resolver possíveis problemas durante a execução.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.