Deploy-Automatico/README.md

🚀 Deploy-Automático — Modelo GitOps (Gitea + Multi-VPS)

Repositório de referência/exemplo da nossa automação de deploy contínuo baseada em Gitea Webhooks + listener na VPS de build + Docker na VPS de produção.

⚠️ Importante: todos os scripts aqui são exemplos sanitizados. Tokens, secrets, senhas de banco, JWT e IPs sensíveis foram substituídos por placeholders (<...>). Nunca commite segredos reais — use variáveis de ambiente / arquivos .env fora do Git.

---

🗺️ Arquitetura (papéis dos servidores)

Servidor	IP (VPN)	Função
VPS 1 — App	10.99.0.1	Execução em produção (containers Docker)
VPS 3 — Data/Git	10.99.0.3	Gitea + PostgreSQL
VPS 4 — Builder	10.99.0.4	Desenvolvimento, build e disparo do deploy

Dev (VPS4) ──git push──► Gitea (VPS3) ──webhook──► listener (VPS4:porta)
                                                        │
                                                        ▼
                                              deploy-*.sh (VPS4)
                                                        │
                                   ┌────────────────────┴────────────────────┐
                                   ▼                                          ▼
                      [Modelo A] build na VPS4 +                 [Modelo B] rsync do fonte +
                      rsync de artefatos → VPS1                  build na VPS1 (docker compose
                      → docker compose restart                   up -d --build)

---

📦 O que tem aqui

.
├── webhook-listener/
│   ├── listener.js                 # Listener genérico do webhook do Gitea (parametrizável por ENV)
│   ├── webhook-listener.service    # Unit systemd de exemplo
│   └── config.example.env          # Variáveis de ambiente do listener
├── scripts/
│   ├── deploy-prod-builder.sh      # Modelo A: build na VPS4 → envia artefato → VPS1 restart
│   ├── deploy-to-prod.sh           # Promoção manual Staging(VPS4) → Produção(VPS1)
│   └── deploy-prod-onhost.sh       # Modelo B: rsync do fonte → build na VPS1
└── docs/
    ├── 01-arquitetura-vps.md
    ├── 02-fluxo-gitops.md
    ├── 03-configurar-webhook-gitea.md
    └── 04-seguranca-deploy.md

🔑 Conceitos-chave da automação

• Um listener por projeto, cada um numa porta própria (ex.: 9000, 9002, 9003), apontando para o deploy-*.sh daquele projeto.
• O listener valida um token, tem trava de concorrência, ignora commits de bump de versão (chore(deploy): bump version) para evitar loop de CI, e reporta o status do commit ao Gitea.
• GitOps: o script de deploy roda git fetch && git reset --hard origin/main — a fonte de verdade é sempre o Gitea, nunca arquivos soltos na VPS de build.

Veja docs/ para o passo a passo completo.