wils@web ~ $ cat ~/ajuda/como-configurar-um-pipeline-ci-cd-com-gitlab-ci-15-e-docker-guia-pratico.md

DevOps

Como configurar um pipeline CI/CD com GitLab CI 15 e Docker: Guia prático

atualizado em 26/08/2026

Este guia prático aborda como configurar um pipeline CI/CD utilizando GitLab CI 15 e Docker, permitindo automação de builds e deploys de aplicações.

Introdução

O GitLab CI é uma ferramenta poderosa para integração contínua e entrega contínua (CI/CD). Combinado com Docker, você pode criar ambientes consistentes e reproduzíveis. Neste guia, vamos configurar um pipeline básico para uma aplicação Docker.

Pré-requisitos

  • Conta no GitLab
  • Repositório GitLab com código fonte
  • Docker instalado em seu ambiente

Passo a Passo

1. Criar um arquivo .gitlab-ci.yml

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

stages:
  - build
  - deploy

2. Configurar a etapa de Build

Adicione a seguinte configuração para construir sua imagem Docker:

build:
  stage: build
  script:
    - docker build -t myapp:${CI_COMMIT_SHA} .

3. Configurar a etapa de Deploy

Agora, configure a etapa de deploy para enviar a imagem para um registro Docker:

deploy:
  stage: deploy
  script:
    - echo $CI_JOB_TOKEN | docker login -u gitlab-ci-token --password-stdin $CI_REGISTRY
    - docker push myapp:${CI_COMMIT_SHA}

4. Variáveis de Ambiente

Certifique-se de que as variáveis de ambiente necessárias estão configuradas no GitLab:

  • CI_REGISTRY: URL do registro Docker
  • CI_JOB_TOKEN: Token de autenticação

Conclusão

Com esses passos, você configurou um pipeline CI/CD básico no GitLab CI com Docker. Agora, sempre que você fizer um push para o repositório, o pipeline será acionado automaticamente.

Dica: Utilize tags e branches para gerenciar diferentes ambientes de deploy (ex: staging e produçã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.