wils@web ~ $ cat ~/ajuda/como-implementar-pipelines-de-ci-cd-com-github-actions-e-docker-guia-passo-a-passo.md

DevOps

Como implementar pipelines de CI/CD com GitHub Actions e Docker: Guia passo a passo

atualizado em 30/08/2026

Implementar pipelines de CI/CD com GitHub Actions e Docker é uma maneira eficiente de automatizar o processo de desenvolvimento e entrega de software. Este guia passo a passo irá ajudá-lo a configurar um pipeline básico usando essas ferramentas.

Pré-requisitos

  • Conta no GitHub
  • Docker instalado localmente
  • Um repositório GitHub para o seu projeto

Passo 1: Criar um Dockerfile

O primeiro passo é criar um Dockerfile no diretório raiz do seu projeto. Este arquivo contém as instruções para construir a imagem Docker.

FROM node:14

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD [ "npm", "start" ]

Passo 2: Configurar GitHub Actions

Agora, crie um diretório chamado .github/workflows no seu repositório e adicione um arquivo YAML para definir o fluxo de trabalho.

name: CI/CD Pipeline

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Check out code
        uses: actions/checkout@v2

      - name: Build Docker image
        run: |
          docker build -t my-app .

      - name: Run tests
        run: |
          docker run my-app npm test

      - name: Push to Docker Hub
        run: |
          echo ${{ secrets.DOCKER_PASSWORD }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
          docker tag my-app myusername/my-app:latest
          docker push myusername/my-app:latest

Passo 3: Configurar Segredos no GitHub

Para que o GitHub Actions possa fazer login no Docker Hub, você precisa adicionar suas credenciais como segredos do repositório.

  1. Vá para o seu repositório no GitHub.
  2. Clique em Settings.
  3. Selecione Secrets e clique em New repository secret.
  4. Adicione DOCKER_USERNAME e DOCKER_PASSWORD.

Passo 4: Testar o Pipeline

Agora, sempre que você fizer push para a branch main, o GitHub Actions irá construir a imagem Docker, executar os testes e, se tudo estiver correto, enviar a imagem para o Docker Hub.

Conclusão

Você agora tem um pipeline de CI/CD básico configurado com GitHub Actions e Docker. Lembre-se de personalizar seus scripts de teste e Dockerfile conforme necessário para o seu projeto específico. Dica: Monitore os logs do GitHub Actions para identificar e corrigir problemas rapidamente.

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.