feat: refactor 30+ skills to Anthropic progressive disclosure pattern
- 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>
This commit is contained in:
118
infraestrutura/skills/vm-migration/references/fase1-easypanel.md
Normal file
118
infraestrutura/skills/vm-migration/references/fase1-easypanel.md
Normal file
@@ -0,0 +1,118 @@
|
||||
# Fase 1: EasyPanel Migration (Week 1-2)
|
||||
|
||||
Target: Migrar 108 containers Docker para VM Proxmox
|
||||
|
||||
## 1.1 Criar VM Docker Host
|
||||
|
||||
```bash
|
||||
qm create 200 \
|
||||
--name easypanel-docker \
|
||||
--memory 32768 \
|
||||
--cores 8 \
|
||||
--net0 virtio,bridge=vmbr0 \
|
||||
--scsi0 rpool/vm-disks:200 \
|
||||
--ostype l26 \
|
||||
--boot order=scsi0
|
||||
|
||||
# Install Ubuntu 24.04 LTS
|
||||
# Via Cloud-Init ou ISO manual
|
||||
```
|
||||
|
||||
## 1.2 Instalar Docker + EasyPanel
|
||||
|
||||
```bash
|
||||
ssh root@10.10.10.200
|
||||
|
||||
# Docker
|
||||
curl -fsSL https://get.docker.com | sh
|
||||
|
||||
# EasyPanel
|
||||
curl -sSL https://get.easypanel.io | sh
|
||||
```
|
||||
|
||||
## 1.3 Backup Containers Actuais
|
||||
|
||||
```bash
|
||||
# Em easy.descomplicar.pt
|
||||
tar -czf /tmp/easypanel-volumes.tar.gz /var/lib/easypanel/projects
|
||||
|
||||
# Transfer para PBS ou storage temporario
|
||||
scp /tmp/easypanel-volumes.tar.gz root@cluster.descomplicar.pt:/mnt/migration/
|
||||
```
|
||||
|
||||
## 1.4 Migrar Containers (Batch 5-10)
|
||||
|
||||
Batch 1 (nao-criticos para teste):
|
||||
|
||||
```bash
|
||||
# Containers teste: dev environments, staging
|
||||
# IDs: 1-5
|
||||
|
||||
# Por cada container:
|
||||
1. Exportar env vars do EasyPanel
|
||||
2. Exportar docker-compose.yml
|
||||
3. Copiar volumes
|
||||
4. Recriar em novo EasyPanel
|
||||
5. Testar health endpoint
|
||||
6. DNS cutover se OK
|
||||
```
|
||||
|
||||
Workflow Batch:
|
||||
|
||||
```bash
|
||||
for container_id in 1 2 3 4 5; do
|
||||
# Export config
|
||||
curl -s http://easy.descomplicar.pt:3000/api/trpc/services.get \
|
||||
-d "serviceId=$container_id" > config_$container_id.json
|
||||
|
||||
# Copiar volumes
|
||||
rsync -avz /var/lib/easypanel/projects/$container_id/ \
|
||||
root@10.10.10.200:/var/lib/easypanel/projects/$container_id/
|
||||
|
||||
# Recriar service (via EasyPanel API ou UI)
|
||||
|
||||
# Test
|
||||
curl -I http://10.10.10.200:PORT/health
|
||||
|
||||
# DNS cutover (se health OK)
|
||||
done
|
||||
```
|
||||
|
||||
## 1.5 Validation (24-48h por batch)
|
||||
|
||||
```
|
||||
Monitoring:
|
||||
- Uptime checks (UptimeRobot ou similar)
|
||||
- Error rates (logs)
|
||||
- Performance (response time <500ms)
|
||||
- Cliente feedback
|
||||
|
||||
Rollback triggers:
|
||||
- >2 containers falham consecutivamente
|
||||
- Cliente reporta down
|
||||
- Health checks fail >10min
|
||||
```
|
||||
|
||||
## 1.6 DNS Cutover
|
||||
|
||||
```bash
|
||||
# Baixar TTL para 300s (5min) 24h ANTES
|
||||
# Ex: Cloudflare ou dns.descomplicar.pt
|
||||
|
||||
# Cutover:
|
||||
A record: old-ip -> NAT port forward para 10.10.10.200:PORT
|
||||
|
||||
# Monitorizar por 1h
|
||||
# Reverter se problemas
|
||||
```
|
||||
|
||||
## 1.7 Rollback Procedure
|
||||
|
||||
```bash
|
||||
# Reverter DNS (TTL 300s = 5min propagacao)
|
||||
# Reactivar container antigo
|
||||
# Investigar causa falha
|
||||
# Re-tentar apos fix
|
||||
```
|
||||
|
||||
Batch 2-N: Repetir ate 108 containers migrados.
|
||||
112
infraestrutura/skills/vm-migration/references/fase2-cwp.md
Normal file
112
infraestrutura/skills/vm-migration/references/fase2-cwp.md
Normal file
@@ -0,0 +1,112 @@
|
||||
# Fase 2: CWP Migration (Week 3-6)
|
||||
|
||||
Target: Migrar 39 vhosts CWP para VM AlmaLinux 8
|
||||
|
||||
**CRITICAL:** 7 dias safety net - server.descomplicar.pt intacto
|
||||
|
||||
## 2.1 Criar VM AlmaLinux 8 + CWP
|
||||
|
||||
```bash
|
||||
qm create 300 \
|
||||
--name cwp-legacy \
|
||||
--memory 16384 \
|
||||
--cores 6 \
|
||||
--net0 virtio,bridge=vmbr0 \
|
||||
--scsi0 rpool/vm-disks:150 \
|
||||
--ostype l26
|
||||
|
||||
# Instalar AlmaLinux 8
|
||||
# Instalar CWP7
|
||||
wget http://centos-webpanel.com/cwp-el8-latest
|
||||
sh cwp-el8-latest
|
||||
```
|
||||
|
||||
## 2.2 Backup CWP Accounts
|
||||
|
||||
```bash
|
||||
# Em server.descomplicar.pt
|
||||
for account in $(cat /tmp/cwp-accounts.txt); do
|
||||
/scripts/pkgacct $account
|
||||
done
|
||||
|
||||
# Transfer backups
|
||||
rsync -avz /home/backup-*/cpmove-*.tar.gz \
|
||||
root@cluster.descomplicar.pt:/mnt/migration/cwp/
|
||||
```
|
||||
|
||||
## 2.3 Migrar Contas (Batch 3-5 contas)
|
||||
|
||||
Workflow por conta:
|
||||
|
||||
```bash
|
||||
# 1. Restore backup em VM CWP
|
||||
scp /mnt/migration/cwp/cpmove-ACCOUNT.tar.gz root@10.10.10.300:/home/
|
||||
|
||||
# 2. Restore via CWP
|
||||
/scripts/restorepkg ACCOUNT
|
||||
|
||||
# 3. Validar:
|
||||
- Site carrega (HTTP 200)
|
||||
- Database conecta
|
||||
- Email funciona (send test)
|
||||
- SSL certificado valido
|
||||
|
||||
# 4. DNS cutover (TTL 300s)
|
||||
A record: site.com -> 10.10.10.300 (via NAT port forward)
|
||||
|
||||
# 5. Monitorizar 24h
|
||||
```
|
||||
|
||||
## 2.4 Validation Period (7 dias)
|
||||
|
||||
```bash
|
||||
# Days 1-7 apos migration:
|
||||
- Server antigo (server.descomplicar.pt) INTACTO
|
||||
- Rollback instantaneo se problema critical
|
||||
- Cliente pode reverter DNS manualmente se necessario
|
||||
|
||||
# Day 7: Confirmar com Emanuel
|
||||
# Se tudo OK -> proceder cleanup
|
||||
# Se problemas -> extend validation ou rollback completo
|
||||
```
|
||||
|
||||
## 2.5 Email Migration
|
||||
|
||||
```bash
|
||||
# Por cada conta CWP:
|
||||
|
||||
# 1. Backup mailboxes
|
||||
tar -czf /tmp/mail-ACCOUNT.tar.gz /home/ACCOUNT/mail/
|
||||
|
||||
# 2. Transfer
|
||||
scp /tmp/mail-ACCOUNT.tar.gz root@10.10.10.300:/tmp/
|
||||
|
||||
# 3. Restore
|
||||
cd /home/ACCOUNT/
|
||||
tar -xzf /tmp/mail-ACCOUNT.tar.gz
|
||||
|
||||
# 4. Fix permissions
|
||||
chown -R ACCOUNT:ACCOUNT /home/ACCOUNT/mail/
|
||||
|
||||
# 5. Testar IMAP/SMTP
|
||||
telnet localhost 143 # IMAP
|
||||
telnet localhost 25 # SMTP
|
||||
```
|
||||
|
||||
## 2.6 Rollback Procedure (Fase 2)
|
||||
|
||||
```bash
|
||||
# Disponivel ate Day 7
|
||||
|
||||
# 1. Reverter DNS (todos sites)
|
||||
A records -> IP antigo (server.descomplicar.pt)
|
||||
|
||||
# 2. Verificar server antigo online
|
||||
ping server.descomplicar.pt
|
||||
|
||||
# 3. Comunicar clientes
|
||||
|
||||
# 4. Analisar causa falha
|
||||
|
||||
# 5. Ajustar plan e re-tentar
|
||||
```
|
||||
@@ -0,0 +1,63 @@
|
||||
# Fase 3: Cluster Formation (Week 7-8)
|
||||
|
||||
Target: Formar cluster 2-node, HA, cleanup
|
||||
|
||||
## 3.1 Preparar server.descomplicar.pt como Node A
|
||||
|
||||
```bash
|
||||
# APENAS apos Fase 2 100% validada
|
||||
|
||||
# Backup final completo
|
||||
tar -czf /tmp/final-backup-server.tar.gz /etc /home /var/www
|
||||
|
||||
# Reformatar com Proxmox (/proxmox-setup)
|
||||
# Tornar Node A do cluster
|
||||
```
|
||||
|
||||
## 3.2 Cluster Formation
|
||||
|
||||
```bash
|
||||
/proxmox-cluster create --node-a server.descomplicar.pt --node-b cluster.descomplicar.pt
|
||||
```
|
||||
|
||||
## 3.3 HA Configuration
|
||||
|
||||
```bash
|
||||
/proxmox-ha configure --critical-vms 200,300
|
||||
```
|
||||
|
||||
## 3.4 Cleanup
|
||||
|
||||
```bash
|
||||
# Cancelar easy.descomplicar.pt VPS (apos validacao)
|
||||
# Backup final de tudo
|
||||
# Documentar nova arquitectura
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Backup Strategy Durante Migration
|
||||
|
||||
### Fase 1 (EasyPanel)
|
||||
|
||||
3 locais:
|
||||
1. Containers em easy.descomplicar.pt (original)
|
||||
2. PBS Node B backup
|
||||
3. easy.descomplicar.pt VPS backup (mantido durante Fase 1)
|
||||
|
||||
### Fase 2 (CWP)
|
||||
|
||||
Safety net 7 dias:
|
||||
1. Server antigo intacto (rollback rapido)
|
||||
2. VM CWP -> PBS backups automaticos
|
||||
3. Backups manuais /mnt/migration/
|
||||
|
||||
RPO: 1h (PBS backups hourly se critical)
|
||||
RTO: 2-4h (restore + DNS propagation)
|
||||
|
||||
### Fase 3 (Cluster)
|
||||
|
||||
Redundancia completa:
|
||||
1. VMs em Node A + Node B
|
||||
2. PBS primary (Node B 16TB)
|
||||
3. PBS secondary remote sync (Node A 12TB)
|
||||
@@ -0,0 +1,48 @@
|
||||
# VM Migration - Troubleshooting
|
||||
|
||||
## Container migration fails
|
||||
|
||||
```bash
|
||||
# Verificar logs
|
||||
docker logs CONTAINER_ID
|
||||
|
||||
# Verificar volumes
|
||||
ls -lah /var/lib/easypanel/projects/PROJECT/
|
||||
|
||||
# Testar manual
|
||||
docker-compose up -d
|
||||
|
||||
# Rollback e investigar
|
||||
```
|
||||
|
||||
## CWP site nao carrega apos migration
|
||||
|
||||
```bash
|
||||
# Verificar Apache
|
||||
systemctl status httpd
|
||||
|
||||
# Verificar vhost
|
||||
cat /usr/local/apache/conf.d/vhosts/DOMAIN.conf
|
||||
|
||||
# Verificar database
|
||||
mysql -u USER -p DATABASE
|
||||
|
||||
# Verificar DNS propagation
|
||||
dig +short DOMAIN @8.8.8.8
|
||||
```
|
||||
|
||||
## Email nao funciona
|
||||
|
||||
```bash
|
||||
# Verificar Postfix
|
||||
systemctl status postfix
|
||||
|
||||
# Testar SMTP
|
||||
telnet localhost 25
|
||||
|
||||
# Verificar DNS MX
|
||||
dig +short MX DOMAIN
|
||||
|
||||
# Verificar logs
|
||||
tail -f /var/log/maillog
|
||||
```
|
||||
Reference in New Issue
Block a user