📝 GitFlow na Prática: Do Congelamento do Código ao Deploy em Produção com CI/CD

# Garanta que a develop está atualizada
git checkout develop
git pull origin develop

# Cria a branch de release com o padrão de versionamento semântico (SemVer)
git checkout -b release/v1.1.0

# Publica a branch no repositório remoto
git push origin release/v1.1.0

# Desenvolvedor corrige o bug na release
git checkout release/v1.1.0
git checkout -b bugfix/corrigir-layout-checkout

# (faz os commits do ajuste...)
git push origin bugfix/corrigir-layout-checkout
# Abre a PR direcionada para: release/v1.1.0

git checkout main
git pull origin main

# Cria uma tag anotada para marcar o release oficial
git tag -a v1.1.0 -m "Release da versão 1.1.0 com novas funcionalidades de checkout"

# Envia a tag para o repositório remoto
git push origin v1.1.0

# 1. Faz o merge da release de volta para a develop
git checkout develop
git pull origin develop
git merge release/v1.1.0

# 2. Envia para o servidor
git push origin develop

# 3. Remove a branch de release que já cumpriu seu papel
git branch -d release/v1.1.0
git push origin --delete release/v1.1.0

(develop)  ----*---*---*------------*-------> (Continua desenvolvimento das próximas features)
                       \              /
   (release)            \---*---*----/          (Testes e correções em Staging)
                             \      /
   (main)     ----------------*----*-----------> (Produção)
                                  \
                                Tag v1.1.0 ---> [ Pipeline CI/CD ] ---> Deploy Produção

name: Pipeline CI/CD - GitFlow

# Defines quando as ações do pipeline serão executadas
on:
  push:
    branches:
      - 'release/*'       # Dispara para branches de release (Staging)
    tags:
      - 'v*.*.*'          # Dispara quando uma tag de versão for publicada (Produção)

jobs:

  # -------------------------------------------------------------
  # JOB 1: DEPLOY EM STAGING (HOMOLOGAÇÃO)
  # -------------------------------------------------------------
  deploy-staging:
    name: Deploy em Staging
    # Roda apenas se o push for para uma branch do tipo release/*
    if: startsWith(github.ref, 'refs/heads/release/')
    runs-on: ubuntu-latest

    steps:
      - name: Baixar o código-fonte
        uses: actions/checkout@v4

      - name: Configurar Node.js (ou sua stack)
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Instalar Dependências e Executar Testes
        run: |
          npm ci
          npm test          

      - name: Build do Artefato para Staging
        run: npm run build -- --mode=staging

      - name: Executar Deploy no Ambiente de Staging
        env:
          STAGING_API_KEY: ${{ secrets.STAGING_API_KEY }}
        run: |
          echo "🚀 Realizando deploy no ambiente de STAGING..."
          # Exemplo: aws s3 sync, docker push, helm upgrade, etc.          

  # -------------------------------------------------------------
  # JOB 2: DEPLOY EM PRODUÇÃO
  # -------------------------------------------------------------
  deploy-production:
    name: Deploy em Produção
    # Roda apenas se for o push de uma TAG (ex: refs/tags/v1.1.0)
    if: startsWith(github.ref, 'refs/tags/v')
    runs-on: ubuntu-latest

    steps:
      - name: Baixar o código-fonte
        uses: actions/checkout@v4

      - name: Extrair o nome da Tag / Versão
        id: vars
        run: echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT

      - name: Configurar Docker Buildx (Exemplo com Containers)
        uses: docker/setup-buildx-action@v3

      - name: Login no Registry de Containers
        uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Build e Push da Imagem Docker da Versão
        uses: docker/build-push-action@v5
        with:
          push: true
          tags: |
            ghcr.io/${{ github.repository }}:${{ steps.vars.outputs.TAG_NAME }}
            ghcr.io/${{ github.repository }}:latest            

      - name: Executar Deploy em Produção (Zero-Downtime)
        env:
          PROD_API_KEY: ${{ secrets.PROD_API_KEY }}
        run: |
          echo "💥 ATENÇÃO: Executando deploy da versão ${{ steps.vars.outputs.TAG_NAME }} em PRODUÇÃO!"
          # Comando para atualizar seu Kubernetes, ECS, EC2, Vercel, etc.