Saltar al contenido principal

Actualizar a nuevas versiones

El framework se actualiza con relativa frecuencia: correcciones de bugs, mejoras de seguridad, nuevas funcionalidades. Mantener tu instalación al día es importante — sobre todo por los parches de seguridad.

Cómo saber si hay actualización​

Ve a Configuración → Actualizaciones. Verás:

  • Versión actual que tienes instalada.
  • Última versión disponible.
  • Notas de cambios (changelog) desde tu versión actual.

Si hay una versión nueva, aparece un botón "Actualizar ahora".

Antes de actualizar​

Siempre, sin excepción:

  • Respalda todo. Genera un paquete o respaldo manual completo. Ver Respaldos.
  • Lee el changelog. Especialmente cambios "breaking" que puedan afectar tus tablas o plugins.
  • Prueba en staging primero si tienes un ambiente separado.

Métodos de actualización​

Método 1: Botón "Actualizar" en el CMS (más simple)​

  1. En Configuración → Actualizaciones, click "Actualizar ahora".
  2. El sistema descarga el paquete, extrae el código nuevo, ejecuta las migraciones de base de datos.
  3. Al terminar, verás la versión nueva.
  • Ventaja: un solo clic.
  • Desventaja: si algo falla a mitad, puedes quedar en un estado intermedio. Por eso el respaldo previo es obligatorio.

Método 2: Descargar paquete y aplicar manualmente​

  1. Desde el CMS, descarga el paquete update (o pídelo si es un cliente).
  2. En Configuración → Empaquetado → Importar paquete, sube el ZIP.
  3. Marca modo "actualización" (solo código, preserva datos).

Método 3: Git pull + migraciones (para técnicos)​

Si tu instalación viene de un clon de git:

cd /ruta/al/framework
git pull origin main
php run_migration.php
sudo ./setup.sh

Actualizaciones mayores vs menores​

Menores (1.10.0 → 1.10.1): correcciones y mejoras. Suelen ser seguras de aplicar sin cambios en la config.

Mayores (1.10.0 → 2.0.0): pueden traer cambios "breaking" que requieran ajustes. Lee el changelog con atención y prueba en staging antes.

Actualizaciones desde el servidor de licencias​

Si tu instalación está bajo el sistema de License Server, las actualizaciones se distribuyen desde el servidor del proveedor:

  • Solo licencias activas pueden descargar actualizaciones.
  • El paquete viene firmado — el cliente verifica autenticidad antes de aplicar.
  • No necesitas token de GitHub ni acceso al repositorio.

Después de actualizar​

  • Verifica que el CMS abre normalmente.
  • Prueba las funcionalidades críticas que usas más.
  • Revisa el log de errores por si aparecen nuevos.
  • Actualiza plugins propios si tienes desarrollos custom que dependan del framework.

Rollback si algo salió mal​

Restaura desde el respaldo que hiciste antes de actualizar. Ver Respaldos.

Si actualizaste sin respaldar (no lo hagas): busca en packages/ si el sistema guardó el paquete de la versión anterior.

Automatizar actualizaciones​

No lo recomendamos para el framework — mejor tener a alguien atento a los cambios y aplicándolos con criterio. Las actualizaciones automáticas silenciosas son la causa #1 de "de repente algo dejó de funcionar".

Actualizaciones de seguridad urgentes​

Cuando el equipo del framework publica una actualización de seguridad:

  • Se marca como urgente en Configuración → Actualizaciones.
  • Aplícala ese mismo día si es posible.
  • Si vas a demorar, al menos revisa qué se corrige — puede ser algo que afecte a tu instalación.

Preguntas frecuentes​

¿Perderé mis datos al actualizar? No, salvo que algo salga muy mal. Los datos y configuraciones se preservan. Por eso el respaldo previo es la red de seguridad.

¿Perderé mis páginas y módulos custom? No — los módulos, páginas y plugins que creaste no se tocan. Solo cambia el código del framework.

¿Mis plugins custom pueden dejar de funcionar? Si el framework cambió una función que tu plugin usaba, sí. Por eso hay que probar en staging.

¿Cuánto tiempo tarda una actualización? Menor: 30 segundos a 2 minutos. Mayor: 2-10 minutos.

¿Hay downtime? Sí, unos segundos mientras se aplican migraciones. Para sitios de alto tráfico, planifica en horario de baja actividad.

¿Qué sigue?​

Con esto tu instalación queda mantenible y sostenible en el tiempo. Si aparecen problemas, ve a Resolver problemas.