<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Como criar pipeline CI/CD do zero com GitHub actions e Docker

DA

6 min

Como criar pipeline CI/CD do zero com GitHub actions e Docker

Aprenda a configurar pipeline CI/CD do zero com GitHub Actions e Docker: testes automatizados, containerização e deploy contínuo em 7 passos práticos.

Neste artigo

O que é pipeline CI/CD e por que aprender agora?

Pipeline CI/CD (Integração Contínua/Entrega Contínua) automatiza o processo de testar, construir e deployar sua aplicação a cada mudança de código. Para desenvolvedores Node.js, isso significa menos tempo manual e mais confiança ao entregar novas funcionalidades. Ao longo deste tutorial, você terá um pipeline funcional que roda testes, constrói uma imagem Docker e publica a versão automática toda vez que você fizer push no GitHub.

Pré-requisitos e ambiente configurado

Antes de começar, certifique-se de ter o seguinte instalado e configurado na sua máquina:

  • Node.js (versão 18 ou superior recomendada)

  • Git configurado com sua conta GitHub

  • Uma conta no Docker Hub ou registro Docker privado

  • O Docker Desktop instalado e rodando

Dica:Se você ainda não tem um repositório Node.js, crie um rapidamente com mkdir my-app && cd my-app && npm init -y.

Passo a passo: do código ao pipeline no GitHub Actions

Vamos criar o arquivo de workflow. No seu repositório, crie a pasta .github/workflows/ e o arquivo ci-cd.yml:

Plano carreira analista de dados microsoft power bi

name: CI/CD Pipeline

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"

      - name: Install dependencies
        run: npm ci

      - name: Run tests
        run: npm test

Isso configura o CI básico: a cada push na branch main ou pull request, o GitHub vai fazer checkout do código, instalar as dependências e rodar os testes definidos no seu package.json.

Integração de Docker e deploy contínuo

Agora vamos containerizar a aplicação e publicar a imagem no Docker Hub. Adicione mais um job ao seu workflow:

- name: Build Docker image
  run: |-
    docker build -t ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }}
    docker login -u ${{ secrets.DOCKER_USERNAME }} -p ${{ secrets.DOCKER_PASSWORD }}
    docker push ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }}

Para que isso funcione, você precisar criar dois secrets no GitHub (Settings > Secrets > Actions): DOCKER_USERNAME e DOCKER_PASSWORD (ou token de acesso). Isso evita que suas credenciais fiquem no código-fonte.

Curso analista ciberseguranca junior cisco

Recursos avançados: testes, cache e múltiplos ambientes

Para pipelines de produção, adicionar cache de dependências acelera significativamente os builds:

- name: Cache node modules
  uses: actions/cache@v4
  with:
    path: ~/.npm
    key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-node

Além disso, você pode separar ambientes usando condições if no workflow. Exemplo: deploy apenas em tags de versão:

- name: Deploy on version tag
  if: startsWith(github.ref, 'refs/tags')
  run: echo "Publicando versão ${{ github.ref_name }}"

Erros comuns e como resolver (Troubleshooting)

Um erro frequente é o EACCES ao rodar o Docker sem permissões de root. A solução é adicionar seu usuário ao grupo Docker: sudo usermod -aG docker $USER e reiniciar a terminal. Outro problema comum é o arquivo .dockerignore esquecido, que pode enviar arquivos desnecessários para o build, aumentando o tamanho da imagem. Crie um .dockerignore com:

Cursos google ciee gratuitos certificado

.dockerignore
node_modules

.DS_Store

*.log

Dica:Use docker compose config para validar sua configuração antes de pushar.

Boas práticas de segurança e produtividade

Nunca armazene senhas ou tokens diretamente no workflow. Sempre use GitHub Secrets. Para imagens Docker, utilize .multhost ou imagens de base oficiais node:20-alpine para reduzir superfície de ataque. Em pipelines maiores, considere o dependabot para atualizações automáticas de dependências e evite rodar o pipeline como root.

Perguntas Frequentes

Como configurar pipeline de CI/CD no GitHub Actions para Node.js?

Basta criar o arquivo .github/workflows/ci.yml com os passos de checkout, setup Node, instalação de dependências via npm ci e execução de testes. Use secrets para credenciais de Docker ou bancos de dados.

Databricks cursos gratuitos portugues

Quais são os melhores plugins para pipeline de teste automático no Jenkins?

O Jenkins oferece plugins como JUnit para reportar resultados em formato XML, Blue Ocean para visualização gráfica e Pipeline Job para definição de jobs complexos. No entanto, a comunidade migra para GitHub Actions ou GitLab CI por serem mais leves e integrarem nativamente com Git.

Como integrar Docker e Kubernetes em um pipeline de entrega contínua?

Após construir e pushar a imagem para um registry, o pipeline pode aplicar o novo versionamento no cluster via kubectl set image ou usar o Argo CD para sincronização declarativa. A chave é ter o kubeconfig configurado com credências de cluster adequadas.

Qual a diferença entre pipeline de CI e pipeline de CD em projetos Ruby on Rails?

Em Ruby on Rails, o pipeline de CI foca em executar o suite de testes (Minitest/RSpec), verificar migrações de banco e validar estruturas. Já o CD automatiza o deploy para ambientes de staging e produção, frequentemente usando Capistrano ou Kamal para implantação zero-downtime, e gems como dotenv para gestão de variáveis de ambiente entre ambientes.

Curso gratuito analise de dados dashboards google looker studio senai

Como automatizar deploy em ambiente de produção usando GitLab CI/CD?

No GitLab, você define jobs de deploy em .gitlab-ci.yml usando script com kubectl, ssh ou ferramentas de deploy como Capistrano. Utilize environments para proteger branches de produção e variables sensíveis via protected variables, evitando exposição acidental no logs.

Quais variáveis de ambiente são necessárias para pipeline CI/CD segura?

As essenciais são: credenciais de registry Docker, senhas de banco de dados, chaves de API de serviços externos e tokens de autenticação. Todas devem ser armazenadas como secrets na plataforma de CI e acessadas via variáveis de ambiente no momento da execução, nunca hardcoded no código-fonte.


Pronto! Você agora tem um pipeline CI/CD funcional do zero, com testes automatizados, containerização Docker e deployment automático. O próximo passo é adaptar esse modelo para sua stack específica (Python, Go, Ruby) ou integrar com Kubernetes para escalas maiores.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Publicado em

Ver perfil do autor

COMPARTILHAR