CloudRecoveryAS/CHANGELOG.md

Changelog

[1.1.4] - 2026-07-31

Recoge todo lo que sigue de esta sección y sustituye a 1.1.3, cuyo artefacto publicado se generó antes de los arreglos: su install.ps1 no traía -UpdateInPlace y su binario llevaba el runner.py que ignoraba --headless en Windows. Actualizar con él mataba el agente, cambiaba la tarea programada a SYSTEM y la dejaba sin arrancar, porque Qt no puede crear su plataforma como SYSTEM en la sesión 0 sin offscreen.

Los paquetes genéricos de Gitea son inmutables, así que se quema el número en lugar de reemplazar 1.1.3: dos contenidos distintos con la misma versión fue exactamente lo que hizo caro el diagnóstico. Hay que reconstruir los binarios aunque el código ya estuviera arreglado, porque __version__ va compilado dentro del ejecutable y el PANEL compara el sello config/.version contra la versión que creía estar instalando.

[Sin publicar]

La actualización de Windows decía que funcionó y no cambiaba nada

Actualizar sobre un servidor con el agente en una carpeta no estándar terminaba en verde y dejaba el servidor con la versión anterior. La causa: todo el camino de Windows identificaba al agente por nombre, mientras que lo único que se actualiza se identifica por ruta.

• install.ps1 alinea la tarea programada con el binario instalado. Start-ScheduledTask ejecuta la ruta registrada en la acción de la tarea, no el -Prefix: si difieren, se copiaba el binario nuevo en un sitio y se arrancaba el viejo del otro. Ahora se reapunta la tarea conservando disparador, principal, ajustes y argumentos; si no se puede corregir, falla.
• La confirmación de arranque mira la ruta del proceso, no solo su nombre. Un agente viejo que nunca se detuvo satisfacía igual de bien un Get-Process -Name CloudRestoreAS. Si la ruta no es legible —un proceso de SYSTEM no la expone a una cuenta sin elevación— se acepta por nombre y se avisa, en vez de revertir una actualización correcta por falta de información.
• Nuevo scripts/emular-actualizacion-windows.ps1: reproduce el escenario completo con un agente falso, sin elevación y sin tocar la instalación real de la máquina. Es lo que destapó este defecto y el siguiente.
• Corregido Merge-EnvFile con un config\.env de una sola línea. Al asignar la salida de un if, PowerShell desenrolla un array de un elemento a escalar, así que $lines.Count reventaba bajo Set-StrictMode y la siembra de credenciales abortaba la instalación.

Instalación y actualización desatendidas en Windows

El instalador de Windows nunca recibió la maquinaria de actualización segura que sí tiene install.sh, y la asimetría se notaba en producción: actualizar desde el PANEL dejaba el servidor sin agente, o fallaba con un error que no correspondía.

• install.ps1 -UpdateInPlace: actualiza una instalación existente conservando su tarea programada y su configuración, y sin correr el bootstrap (una segunda instancia purgaría el Temp\ de la que está viva). Es el modo que usa el PANEL para actualizar.
• No se interrumpe una restauración en curso (Temp\ no vacío): sale con 75 (EX_TEMPFAIL), que el PANEL traduce a "reintenta luego". Windows no tenía esta guarda y una reinstalación a destiempo se llevaba por delante el respaldo que se estuviera restaurando, dejándolo vetado y la base en SINGLE_USER.
• Respaldo y reversión automática: si el binario nuevo no arranca, se vuelve al anterior. El respaldo solo se descarta tras confirmar que la versión nueva corre.
• Rearranque garantizado en todos los modos. La detención corría siempre, pero solo -Service volvía a arrancar algo: actualizar con desktop o none mataba el agente y se iba sin dejar señal.
• La espera a que el SO libere el .exe pasa de 5 s a 30 s con reintentos de la copia: con un antivirus escaneando un onefile de ~270 MB, 5 s se quedaban cortos y la copia abortaba.
• Se distingue "no es administrador" de "es administrador con el token filtrado por UAC", que es lo que recibe una sesión de OpenSSH. Se veían idénticos y el remedio es el opuesto: el segundo no se arregla cambiando de cuenta sino con LocalAccountTokenFilterPolicy.

--headless ahora funciona en Windows

_ensure_qt_platform() salía de inmediato en win32, así que la bandera no hacía nada ahí. La tarea ONSTART corre como SYSTEM en la sesión 0, sin escritorio interactivo, y arrancaba con el plugin Qt windows intentando crear una ventana real. En Linux el mismo modo funcionaba porque el unit de systemd fija QT_QPA_PLATFORM=offscreen por fuera, y esa asimetría escondió el defecto. Ahora --headless fuerza offscreen en todas las plataformas y no se muestra ventana.

Documentación

• README.md afirmaba que la app no puede correr como servicio de Windows y sugería NSSM, lo que contradecía a install.ps1 desde que existe. Corregido.
• packaging/LEEME.txt solo documentaba el camino manual para Windows; ahora incluye el instalador, igual que ya hacía para Linux.

[1.1.0] - 2026-07-29

Distribución e instalación automatizada vía Gitea + PANEL

Publicación de versiones

• Artefactos con versión en el nombre: CloudRestoreAS-<version>-{linux,win}-<arch>.{tar.gz,zip}, más SHA256SUMS y release.json (manifiesto con sha256, tamaño y deps embebidas).
• packaging/scripts/publish-release.sh: publica en los paquetes genéricos de Gitea (ADUANASOFT/generic/cloudrestoreas/<version>) y verifica el sha256 contra la propia API de Gitea antes de dar la publicación por buena. Soporta --dry-run, --force y --notify-panel.
• build-all.sh --publish encadena build → empaquetado → publicación. Se niega a publicar si falta una plataforma: los paquetes genéricos son inmutables y corregirlo quemaría el número de versión.

Contrato con el PANEL

• POST /api/restore/instance-config ahora reporta también platform y arch, para que el PANEL sepa qué artefacto le corresponde a cada servidor.
• processed_folder ya se envía en ese mismo reporte (antes se calculaba, no se mandaba).

Instaladores

• Nuevo install.ps1: instalador de despliegue Windows, autocontenido. Registra una tarea programada ONSTART como SYSTEM para el 24/7 headless — sin NSSM ni descargas en el servidor destino. Detiene la instancia en ejecución antes de reemplazar el .exe.
• El antiguo install.ps1 (preparación del entorno de desarrollo: Python, venv, pip) se movió a scripts/dev-setup.ps1. Se estaba empaquetando por error en el zip del ejecutable autocontenido, que no necesita nada de eso.
• install.sh e install.ps1 aceptan --panel-env-file / -PanelEnvFile: fusionan las claves CLOUDRESTORE_PANEL_* en config/.env (replace-or-append, idempotente, con lista blanca) y borran el archivo. El token viaja por archivo 0600, nunca por argumentos, para que no quede visible en ps ni en el historial del destino.
• install.sh detiene el servicio antes de reemplazar el binario y lo vuelve a levantar si estaba activo. (La razón que se dio aquí —que un ELF en ejecución da ETXTBSY— era incorrecta: eso le pasa a cp, no a install, que desvincula el destino antes de crearlo. Ver BUILD.md.)

Versionado

• app/__init__.py es la fuente única de la versión; el diálogo Acerca de ya no la trae hardcodeada.
• Flag --version en el binario, y sello config/.version que escribe el bootstrap (el instalador remoto lo lee por SFTP, porque el .exe se compila con console=False).
• El .exe ya lleva metadatos de versión de Windows (VSVersionInfo).

Correcciones

• config/7zip y config/odbc se re-despliegan cuando el build trae otras versiones embebidas, comparando un sello con el sha256 de bundled-versions.json. Antes solo se copiaban si la carpeta estaba vacía, así que una actualización con driver ODBC nuevo conservaba el viejo indefinidamente.

[1.0.0] - 2026-01-25

Lanzamiento Inicial

Características Principales

• ✅ Interfaz gráfica completa con PySide6/Qt
• ✅ Motor de procesamiento concurrente con workers configurables
• ✅ Vigilancia automática de carpeta de entrada
• ✅ Soporte para archivos ZIP multipart (.zip.001, .zip.002, etc.)
• ✅ Extracción automática con 7-Zip
• ✅ Restauración automática de bases de datos SQL Server
• ✅ Sistema de mapeo de nodos (archivo → base de datos)
• ✅ Minimización a bandeja del sistema (system tray)
• ✅ Base de datos SQLite para métricas y auditoría
• ✅ Logging rotativo con múltiples niveles
• ✅ Cifrado de contraseñas con DPAPI
• ✅ Soporte Windows Auth y SQL Auth
• ✅ Modo Dry Run para pruebas
• ✅ Detección de estabilidad de archivos
• ✅ Soporte para marcador .ready
• ✅ Timeouts configurables
• ✅ Tolerancia a fallos y manejo de errores

Tabs de la Interfaz

• Dashboard: Estadísticas en tiempo real
• Jobs: Gestión y visualización de jobs con detalles
• Nodos: CRUD de mapeos nodo → base de datos
• Configuración: Configuración completa de la aplicación
• Logs: Visualización de eventos y logs

Base de Datos

• Tabla jobs: Registro completo de jobs
• Tabla job_steps: Pasos detallados de cada job
• Tabla nodes: Mapeos de nodos
• Tabla events: Log de eventos
• Tabla config: Configuración persistente

Documentación

• README.md: Documentación completa
• QUICKSTART.md: Guía rápida de inicio
• ADVANCED.md: Configuración avanzada
• SCRIPTS.md: Ejemplos de scripts de automatización

Scripts Incluidos

• runner.py: Punto de entrada principal
• install.ps1: Script de instalación automática
• build.ps1: Script para generar ejecutable con PyInstaller
• test_installation.py: Script de verificación de instalación

Requisitos del Sistema

• Windows 10/11 o Windows Server 2019/2022+
• Python 3.11+
• 7-Zip
• ODBC Driver 17 for SQL Server
• SQL Server 2016+ (destino de restauraciones)

Dependencias

• PySide6 >= 6.6.0
• pyodbc >= 5.0.0
• pywin32 >= 306

Características Futuras Planificadas

v1.1.0 (Próximo Release)

• Reintentos automáticos configurables desde UI
• Notificaciones por email
• Verificación de espacio en disco antes de procesar
• Soporte para múltiples instancias SQL Server
• Importación/Exportación de nodos desde CSV
• Dashboard mejorado con gráficos
• Filtros avanzados en tabla de jobs

v1.2.0 (Futuro)

• API REST para integración externa
• Webhooks para notificaciones
• Programación de restauraciones (scheduling)
• Soporte para otros formatos de compresión (RAR, TAR)
• Modo cluster (múltiples instancias coordinadas)
• Soporte para Azure SQL Database
• Backup/Restore de configuración desde UI

v2.0.0 (Largo Plazo)

• Soporte multiplataforma (Linux)
• Interfaz web opcional
• Modo servicio de Windows
• Soporte para PostgreSQL y MySQL
• Machine learning para predicción de tiempos
• Dashboard en tiempo real con WebSockets

Problemas Conocidos

Limitaciones Actuales

• Solo soporta una configuración SQL Server (no múltiples instancias)
• Reintentos automáticos no expuestos en UI (requiere edición manual)
• No hay verificación automática de espacio en disco
• System tray no muestra notificaciones toast
• No hay soporte nativo para archivos RAR

Workarounds Documentados

• Múltiples instancias SQL: Ver ADVANCED.md sección 7
• Notificaciones: Ver SCRIPTS.md para monitoreo externo
• Limpieza automática: Ver SCRIPTS.md para scripts de limpieza

Notas de Seguridad

• Las contraseñas se cifran con DPAPI (vinculadas a usuario/máquina)
• Los logs pueden contener información sensible (rutas, nombres de DB)
• Se recomienda ejecutar con cuenta de servicio dedicada
• Asegurar permisos apropiados en carpetas de trabajo

Agradecimientos

Desarrollado por el equipo de Aduanasoft para automatización de restauraciones de bases de datos SQL Server.

---

Nota de Versión: Esta es la versión inicial de CloudRestoreAS. Se agradecen comentarios y sugerencias para futuras versiones.