Files
claude-plugins/infraestrutura/skills/cwp-backup/SKILL.md
Emanuel Almeida 2cb3210962 feat: adiciona 12 plugins Descomplicar ao marketplace
Plugins: automacao, crm-ops, design-media, dev-tools, gestao,
infraestrutura, marketing, negocio, perfex-dev, project-manager,
wordpress + hello-plugin (existente).

Totais: 83 skills, 44 agents, 12 datasets.json

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:41:24 +00:00

4.8 KiB

name, description, author, version, quality_score, user_invocable, desk_task
name description author version quality_score user_invocable desk_task
cwp-backup CWP backup creation and management using official scripts. Creates user backups, manages backup locations. Based on official CWP documentation only. Use when user mentions "backup cwp", "restaurar cwp", "backup conta", "user backup". Descomplicar® Crescimento Digital 1.0.0 70 true null

/cwp-backup - Backups CWP (Documentação Oficial)

Gestão de backups no CWP usando scripts oficiais. Zero assumptions, zero hallucinations - apenas comandos documentados.

REGRA #38 - ZERO INVENCAO: NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessario. Usar APENAS scripts oficiais.


Servidor Alvo

Servidor IP MCP User
CWP Principal 176.9.3.158 ssh-unified root

Documentação Base


Paths Oficiais

Path Descrição
/backup/ Localização padrão de backups
/scripts/user_backup Script de backup de utilizador
/usr/local/cwpsrv/htdocs/resources/admin/include/cron_backup.php Cron de backup

Comando Principal de Backup

Criar Backup de Utilizador

# COMANDO OFICIAL DOCUMENTADO
sh /scripts/user_backup USERNAME

Nota: Este comando cria um backup completo da conta incluindo:

  • Ficheiros do site
  • Bases de dados
  • Emails
  • Configurações

Scripts de Consulta

# Listar utilizadores disponíveis para backup
sh /scripts/list_users

# Verificar owner de domínio
sh /scripts/whoowns DOMINIO

Localização dos Backups

# Ver backups existentes
ls -lh /backup/

# Espaço usado por backups
du -sh /backup/

Workflows

1. Criar Backup Completo de Conta

# 1. Identificar username
sh /scripts/whoowns DOMINIO

# 2. Criar backup
sh /scripts/user_backup USERNAME

# 3. Verificar criação
ls -lh /backup/ | grep USERNAME

2. Backup Antes de Operação Crítica

# SEMPRE fazer backup antes de:
# - Actualizar WordPress
# - Migrar site
# - Alterações massivas

sh /scripts/user_backup USERNAME

3. Verificar Espaço Disponível

# Antes de criar backup, verificar espaço
df -h /backup

# Tamanho de conta específica
du -sh /home/USERNAME/

Configuração de Backups Automáticos

Via CWP Admin:

  • CWP.admin → CWP Settings → Backup Configuration

Cron (documentado):

# O CWP usa este script para backups agendados
/usr/local/cwpsrv/htdocs/resources/admin/include/cron_backup.php

Limitações Conhecidas (Documentadas)

Limitação Descrição
GUI Restore Documentação menciona que "não funciona confiavelmente"
Tamanho Backups grandes podem demorar
Espaço Verificar espaço antes de criar

Anti-Patterns (NUNCA FAZER)

Anti-Pattern Risco Alternativa
Backup sem verificar espaço Disco cheio df -h primeiro
Confiar só em backups locais Perda total Backup remoto também
Restaurar via GUI Falha Restaurar manualmente
Não testar backups Backup inválido Testar periodicamente

Validação Pós-Backup

# 1. Verificar ficheiro criado
ls -lh /backup/ | grep USERNAME | tail -1

# 2. Verificar integridade (tar)
tar -tzf /backup/BACKUP_FILE.tar.gz > /dev/null && echo "OK" || echo "CORRUPTO"

# 3. Verificar tamanho razoável
# (deve ser similar ao tamanho da conta)
du -sh /home/USERNAME/
ls -lh /backup/BACKUP_FILE.tar.gz

Restauro Manual (Procedimento Seguro)

Nota: O restauro via GUI não é fiável segundo documentação. Procedimento manual:

# 1. Extrair backup para pasta temporária
mkdir /tmp/restore_test
tar -xzf /backup/BACKUP_FILE.tar.gz -C /tmp/restore_test

# 2. Verificar conteúdo
ls -la /tmp/restore_test/

# 3. Restaurar ficheiros manualmente
# (copiar para localização correcta)

# 4. Corrigir permissões
chown -R USERNAME:USERNAME /home/USERNAME/public_html/

# 5. Limpar temporário
rm -rf /tmp/restore_test

Checklist de Execução

  • Verificar espaço em disco (df -h)
  • Identificar username correcto
  • Executar sh /scripts/user_backup USERNAME
  • Verificar ficheiro criado
  • Testar integridade do backup
  • Documentar backup realizado

Boas Práticas

  1. Backup antes de qualquer operação destrutiva
  2. Manter backups remotos (Google Drive, S3)
  3. Testar restauro periodicamente
  4. Documentar localização de backups
  5. Limpar backups antigos (>30 dias)

Versão: 1.0.0 | Autor: Descomplicar® Fonte: wiki.centos-webpanel.com/cwp-scripts, wiki.centos-webpanel.com/category/backups