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

DevOps

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

atualizado em 21/08/2026

Implementar um pipeline de CI/CD com GitLab CI e Docker é uma forma eficiente de automatizar o processo de construção, teste e implantação de aplicações. Este guia passo a passo irá ajudá-lo a configurar um pipeline básico utilizando essas tecnologias.

Pré-requisitos

  • Conta no GitLab
  • Docker instalado na sua máquina
  • Um repositório GitLab para o seu projeto

Passo 1: Criar um arquivo Dockerfile

No diretório raiz do seu projeto, crie um arquivo chamado Dockerfile. Este arquivo define a imagem Docker que será utilizada.

FROM node:14

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD [ "npm", "start" ]

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

Este arquivo irá definir as etapas do seu pipeline. Crie um arquivo chamado .gitlab-ci.yml no diretório raiz do seu projeto.

image: docker:latest

services:
  - docker:dind

stages:
  - build
  - test
  - deploy

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

test:
  stage: test
  script:
    - docker run myapp:latest npm test

deploy:
  stage: deploy
  script:
    - echo "Deploying to production..."
    - docker run -d -p 80:3000 myapp:latest

Passo 3: Configurar variáveis de ambiente

No GitLab, vá até Settings > CI / CD > Variables e adicione as variáveis necessárias, como DOCKER_USERNAME e DOCKER_PASSWORD.

Passo 4: Executar o pipeline

Após fazer commit das alterações no seu repositório, o GitLab CI/CD irá automaticamente iniciar o pipeline. Você pode acompanhar o progresso na aba CI/CD do seu projeto.

Conclusão

Com esses passos, você configurou um pipeline básico de CI/CD utilizando GitLab CI e Docker. Para aprimorar seu pipeline, considere adicionar mais etapas, como análise de código ou notificações.

Dica: Utilize docker-compose para gerenciar aplicações com múltiplos serviços.

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.