Copias de seguridad

Copia completa y semanal de cada VPS sin apagarlo, con 4 copias guardadas, copia a mano y descarga con enlace de 72 horas.

Categoría: Servidores e infraestructura
Estado: Disponible
Requisitos: Un VPS de la empresa (encendido o apagado); Para ver las copias: acceso al VPS; Para pedir una copia, una descarga o cambiar la exclusión: ser admin de la empresa
Herramientas MCP (Solo leen): listar_backups_vps, ver_backup_vps, ver_estado_descarga_backup_vps
Herramientas MCP (Destructivas): crear_backup_vps, crear_descarga_backup_vps, configurar_backups_vps

Markdown

¿Qué permite hacer?

Tener una copia automática de cada VPS cada 7 días, sin apagarlo.
Pedir una copia fuera de horario.
Descargar una copia completa en un .tar con un enlace que vence a las 72 horas.
Excluir un VPS de las copias automáticas, o volver a incluirlo.
Conservar para siempre la última copia de un VPS que se elimina.

¿Cuándo conviene usarlo?

Antes de un cambio grande (migrar una base, actualizar el sistema): pedir una copia a mano.
Para llevarse una imagen completa del VPS fuera de ArduMaker.
Para un VPS de pruebas que no hace falta respaldar: excluirlo.

¿Cómo funciona en ArduMaker?

El ciclo

Cada VPS activo o apagado entra en el ciclo cada 7 días.
Se toma un snapshot en caliente: el VPS sigue funcionando.
Las copias se procesan de a una, porque una copia carga el disco y la red del host, que atiende a otros VPS.
Si una copia falla, se reintenta con espera creciente (30 minutos, 1 hora, 2 horas… hasta 24 horas).
Se conservan las últimas 4 copias; las anteriores se borran solas.
Antes de guardarla se verifica la integridad; una copia que no coincide se descarta.

Copia a mano y descarga

Un admin pide la copia (crear_backup_vps). No corre en el pedido: queda en cola y la toma el proceso de copias; tarda minutos.
Una vez completada, un admin pide la descarga (crear_descarga_backup_vps). La plataforma prepara el archivo y envía por correo un enlace a quien la pidió.
El estado de la descarga pasa por pending, staging y ready (o expired, failed). Con ready aparece la url.
El enlace vence a las 72 horas.

¿Qué cambia realmente?

Nada cambia dentro del VPS: el snapshot temporal se borra al terminar, también si falla.
La copia queda en almacenamiento de ArduMaker, fuera del host del VPS.
Al eliminar un VPS, su última copia se guarda para siempre; si esa copia no se puede hacer, el VPS no se borra y queda detenido con una alerta.
Excluir un VPS deja de copiarlo; las copias existentes quedan, pero dejan de renovarse.

Qué hay en una copia

Un único .tar, porque las piezas sueltas no restauran nada:

Archivo	Qué contiene
`LEEME.md`	Cómo restaurar a mano, con el nombre del VPS y sus dominios
`instancia.tar.gz`	La instancia completa, con sus snapshots y sus redirecciones de puerto
`nginx/`	La configuración de nginx de los dominios del VPS en el host
`letsencrypt/`	Los certificados de los dominios propios
`manifiesto.json`	Plan, dominios, repositorios y empresa; los dominios sin certificado en la copia, en `ssl_domains_excluidos`
`SHA256SUMS`	Sumas para detectar corrupción parcial

Los certificados de la plataforma (zona de ArduMaker) no viajan en la copia: quien restaure en otro lado necesita uno propio. No hay una herramienta para restaurar automáticamente: el LEEME.md explica el procedimiento manual.

Esquema

Snapshot en caliente: el VPS sigue andando
Exportación: instancia + nginx + certificados + manifiesto
Verificación: sumas de control
Almacenamiento de ArduMaker: se guardan las últimas 4
Descarga (opcional): enlace por correo, 72 h

Una copia, de punta a punta

Resultado esperado

listar_backups_vps devuelve las copias de la más nueva a la más vieja, con estado, tamaño, fecha y si hay una descarga preparada.
ver_backup_vps muestra qué contiene cada copia según su manifiesto.
Un miembro ve solo las copias completadas; un admin de la empresa ve también los intentos fallidos, pero no el motivo técnico, que habla de infraestructura compartida.

sha256sum -c SHA256SUMS

Errores y resolución

Respuesta	Causa	Qué hacer
400 VPS excluido	El VPS está excluido de las copias	Incluirlo con `configurar_backups_vps`
409	Ya hay una copia en cola o corriendo	Esperar a que termine
429	Se pidió otra copia hace menos de 60 minutos, o hay 3 descargas vivas en la empresa	Esperar, o bajar o dejar vencer descargas
400 al pedir descarga	La copia no está completada o no tiene archivo	Elegir una copia completada
404 `Backup not found`	No existe, o es un intento fallido que un miembro no puede ver	Pedírselo a un admin

Pedir la descarga dos veces devuelve la misma mientras esté viva. crear_backup_vps y crear_descarga_backup_vps aceptan idempotency_key. Borrar una copia no se puede desde MCP.

Relación con MCP

Sí, en los perfiles /mcp y /mcp/vps.

Herramienta	Tipo	Permiso
`listar_backups_vps`, `ver_backup_vps`	Lectura	Acceso al VPS
`ver_estado_descarga_backup_vps`	Lectura	Admin (la respuesta trae el enlace)
`crear_backup_vps`	Escritura	Admin; una por hora por VPS
`crear_descarga_backup_vps`	Escritura (dato sensible)	Admin
`configurar_backups_vps`	Escritura	Admin

No hay herramienta para borrar copias: es irreversible y deja al VPS con un respaldo menos. Referencia en /mcp/docs y ejemplos en /mcp/vps.