Emanuel Almeida
6b3a6f2698
- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.2 KiB
4.2 KiB
name, description
| name | description |
|---|---|
| vm-migration | Migracao zero-downtime de workloads CWP e EasyPanel para VMs Proxmox com safety nets e rollback procedures. |
VM Migration
Migracao zero-downtime de workloads CWP e EasyPanel para Proxmox VMs seguindo Migration-Plan-OptionA com safety nets e rollback procedures.
Quando Usar
- Migrar servidores CWP para VMs Proxmox
- Migrar containers EasyPanel para VMs Proxmox
- Executar Migration-Plan-OptionA (3 fases)
- Migracao phased com validation periods
Quando Nao Usar
- Migracoes non-CWP/EasyPanel (criar plan especifico)
- Ambientes teste/dev (menos rigor)
- Single-server setups (nao cluster)
Sintaxe
/vm-migration <source-type> <source-host> [--phase 1|2|3] [--batch-size 5] [--validate-days 7]
Exemplos
# Fase 1: EasyPanel migration (batch 5 containers)
/vm-migration easypanel easy.descomplicar.pt --phase 1 --batch-size 5
# Fase 2: CWP migration com 7 dias validation
/vm-migration cwp server.descomplicar.pt --phase 2 --validate-days 7
# Fase 3: Apenas confirmar (sem migracao)
/vm-migration finalize --phase 3
Knowledge Sources (Consultar SEMPRE)
mcp__notebooklm__notebook_query \
notebook_id:"276ccdde-6b95-42a3-ad96-4e64d64c8d52" \
query:"proxmox migration cwp easypanel docker lxc zero downtime"
Hub Docs: Hub/05-Projectos/Cluster Descomplicar/Planning/Migration-Plan-OptionA.md
Migration-Plan-OptionA Overview
Timeline: 8 semanas | Strategy: Phased migration com safety nets | Rollback: Disponivel em cada fase
Week 1-2: FASE 1 - EasyPanel Migration
+-- Backup EasyPanel -> PBS
+-- Create Docker VM Proxmox
+-- Migrate containers (batch 5-10)
+-- DNS cutover gradual
+-- Validation + Rollback window
Week 3-6: FASE 2 - CWP Migration
+-- 7 dias safety net (server intacto)
+-- Create AlmaLinux 8 VM
+-- Migrate CWP accounts (batch)
+-- Validate sites + email
+-- DNS cutover (TTL 300s)
+-- Rollback ate Day 7
Week 7-8: FASE 3 - Cluster Formation
+-- Prepare server.descomplicar.pt as Node A
+-- Form cluster (pvecm)
+-- Configure HA groups
+-- Live migration tests
+-- Cleanup legacy servers
Workflow Pre-Migration (Todas Fases)
1. Backup Strategy Validation
# Verificar PBS configurado
pvesm status | grep pbs
# Criar backup point actual
vzdump --storage pbs-main --all 1 --mode snapshot
Garantir 3-2-1 compliance: original + PBS Node B + PBS Node A remote sync.
2. Documentar Estado Actual
# CWP: Listar contas
/scripts/list_accounts > /tmp/cwp-accounts.txt
# EasyPanel: Listar services
curl -s http://localhost:3000/api/trpc/projects.list | jq > /tmp/easypanel-services.json
# DNS TTLs (baixar para 300s ANTES de migration)
3. Comunicar Clientes (se downtime esperado)
- Email 48h antes
- Status page update
- Janela de manutencao agendada
Fases Detalhadas
| Fase | Detalhes | Referencia |
|---|---|---|
| Fase 1: EasyPanel (Week 1-2) | 108 containers Docker -> VM Proxmox | references/fase1-easypanel.md |
| Fase 2: CWP (Week 3-6) | 39 vhosts CWP -> VM AlmaLinux 8 | references/fase2-cwp.md |
| Fase 3: Cluster (Week 7-8) | 2-node cluster, HA, cleanup | references/fase3-cluster.md |
| Troubleshooting | Problemas comuns e resolucao | references/troubleshooting.md |
Backup Strategy Resumo
| Fase | Locais Backup | RPO | RTO |
|---|---|---|---|
| Fase 1 | Original + PBS + VPS | 1h | 2-4h |
| Fase 2 | Server intacto + PBS + /mnt/migration/ | 1h | 2-4h |
| Fase 3 | Node A + Node B + PBS dual | 1h | 2-4h |
Anti-Patterns
| Anti-Pattern | Risco | Alternativa |
|---|---|---|
| Migrar tudo de uma vez | Downtime total | Batches de 5-10 |
| Nao baixar TTL antes | DNS lento a propagar | TTL 300s 24h antes |
| Apagar server antigo cedo | Sem rollback | Manter 7 dias |
| Sem backup pre-migration | Perda dados | vzdump + 3-2-1 |
References
- Migration Plan: Hub/05-Projectos/Cluster Descomplicar/Planning/Migration-Plan-OptionA.md
- NotebookLM: 276ccdde-6b95-42a3-ad96-4e64d64c8d52
- Guia Hub: Guia-Definitivo-Proxmox-Hetzner.md (Modulo 4: Workloads)
- Desk CRM: Projecto #65, Tarefa #1712