wils@web ~ $ cat ~/ajuda/como-implementar-um-pipeline-de-ci-cd-utilizando-gitlab-ci-cd-e-docker-guia-passo-a-passo.md

DevOps

Como implementar um pipeline de CI/CD utilizando GitLab CI/CD e Docker: Guia passo a passo

atualizado em 31/08/2026

Implementar um pipeline de CI/CD utilizando GitLab CI/CD e Docker é uma maneira eficiente de automatizar o processo de integração e entrega de software. Este guia passo a passo irá ajudá-lo a configurar um pipeline básico.

Pré-requisitos

  • Conta no GitLab
  • Docker instalado no servidor
  • Um projeto GitLab existente

Passo 1: Criar um arquivo .gitlab-ci.yml

No diretório raiz do seu projeto, crie um arquivo chamado .gitlab-ci.yml. Este arquivo definirá as etapas do seu pipeline.

Exemplo de .gitlab-ci.yml

image: docker:latest

services:
  - docker:dind

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - docker build -t myapp .

test:
  stage: test
  script:
    - docker run myapp pytest

deploy:
  stage: deploy
  script:
    - echo "Deploying to production..."

Passo 2: Configurar variáveis de ambiente

No GitLab, vá para Configurações do Projeto > CI/CD > Variáveis e adicione variáveis como DOCKER_USERNAME e DOCKER_PASSWORD para autenticação no Docker Hub.

Passo 3: Configurar Runner do GitLab

Certifique-se de que seu projeto tenha um GitLab Runner registrado. Você pode usar o seguinte comando para registrar um novo Runner:

gitlab-runner register

Passo 4: Testar o pipeline

Faça um commit e envie para o repositório. O GitLab irá automaticamente iniciar o pipeline. Você pode verificar o status na aba CI/CD.

Conclusão

Agora você tem um pipeline básico de CI/CD configurado com GitLab e Docker. Para aprimorar seu pipeline, considere adicionar etapas de notificação e monitoramento.

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.