@codigodoleo/wp-kit 1.0.0

package/modules/docs/templates/docs/Deploy-Pipeline.md

@@ -0,0 +1,113 @@
+# Pipeline CI/CD - Pipefy Website
+
+## Visão Geral
+Pipeline automatizado para deploy do WordPress da Pipefy com integração ao fluxo de desenvolvimento da equipe.
+
+## Ambientes e Triggers
+
+### Development
+- **Trigger**: Push na branch `develop`
+- **Namespace**: `website-dev`
+- **URL Cache**: `assets-site.staticpipefy.com/development/`
+
+### Staging
+- **Trigger**: Push na branch `staging`
+- **Namespace**: `website-stg`
+- **URL Cache**: `assets-site.staticpipefy.com/staging/`
+
+### Production
+- **Trigger**: Push na branch `master` (apenas de branches `release/*` ou `hotfix/*`)
+- **Namespace**: `website-prod`
+- **URL Cache**: `assets-site.staticpipefy.com/production/`
+
+## Stages do Pipeline
+
+### 1. Validation
+- **kubeval**: Valida arquivos Kubernetes antes do deploy
+
+### 2. Compiler
+- **build-wordpress**: Compila tema e plugins WordPress
+
+### 3. Image Build
+- **image-build**: Constrói imagem Docker com tag do commit
+
+### 4. Deploy
+- **deploy**: Deploy no ambiente (manual)
+- **clear-cache**: Limpa cache do Cloudflare
+
+### 5. Tests
+- **smoke-stg-website**: Testes de fumaça no staging
+- **smoke-prod-website**: Testes de fumaça na produção
+
+### 6. Rollback
+- **rollback**: Executado automaticamente em caso de falha
+
+## Fluxo de Desenvolvimento Integrado
+
+### Feature Development
+1. Desenvolver na branch `feature/*`
+2. Merge para `develop` → Deploy automático no Development
+3. Teste no ambiente de desenvolvimento
+
+### Release Process
+1. Criar branch `release/*` a partir de `develop`
+2. Merge para `staging` → Deploy no Staging
+3. Testes de aceitação no staging
+4. Merge para `master` → Deploy manual na Production
+
+### Hotfix Process
+1. Criar branch `hotfix/*` a partir de `master`
+2. Deploy direto na production após aprovação
+3. Backport para `develop` e `staging`
+
+## Jobs Principais
+
+| Job | Objetivo | Quando Executa |
+|-----|----------|---------------|
+| `build-wordpress` | Compila código WordPress | Todos os pushes |
+| `image-build` | Cria imagem Docker | Após compilação |
+| `deploy` | Deploy no K8s | Manual (staging/prod) |
+| `clear-cache` | Limpa cache CDN | Após deploy |
+| `smoke-tests` | Valida deploy | Após deploy |
+
+## Configurações Importantes
+
+- **Registry**: `$CI_REGISTRY_IMAGE:latest`
+- **Kubernetes**: Oracle Cloud Infrastructure (OCI)
+- **CDN**: Cloudflare
+- **Storage**: PVC com `ReadWriteMany`
+
+## Monitoramento
+
+- Logs disponíveis no GitLab CI/CD
+- Métricas de performance via smoke tests
+- Notificações de falha automáticas
+
+## ⚠️ Restauração de Banco de Dados (Staging)
+
+> **🚨 AÇÃO DESTRUTIVA - ACESSO RESTRITO**  
+> Este processo substitui completamente o banco de dados do staging pelos dados de produção.  
+> **Permitido apenas para:** Desenvolvedores Seniores e Owners  
+> **Consequência:** Todos os dados atuais do staging serão **perdidos permanentemente**
+
+### 📋 Processo de Restauração
+
+1. **🎯 Acesse o GitLab:**
+   - Navegue até [CI/CD → Schedules](https://gitlab.com/pipefy/wordpress/pipefy-website/-/pipeline_schedules)
+
+2. **📥 Backup do Banco de Produção:**
+   - Clique no botão ▶️ **Play** no pipeline agendado `Download Prod Database`
+   - ⏱️ Aguarde a conclusão (cria backup e armazena no bucket S3)
+
+3. **🔄 Replicação para Staging:**
+   - Após finalizar o step anterior, clique no botão ▶️ **Play** no pipeline `Replicate Production DB into Staging DB`
+   - 📦 Este job utiliza o backup armazenado no bucket S3
+
+4. **✅ Finalização:**
+   - Staging atualizado com dados de produção
+   - 🧪 Execute testes para validar a integridade dos dados
+
+### ⚡ Importante
+- ⏰ O processo pode levar alguns minutos dependendo do tamanho do banco
+- 🔍 Monitore os logs dos jobs para identificar possíveis erros
+- 📞 Em caso de problemas, contate imediatamente a equipe de infraestrutura