Actualización en línea

Qué permite hacer

KingCMS X1 puede comprobar nuevas versiones en el panel de administración y actualizar a una nueva versión con un solo clic. El código y la base de datos se respaldan automáticamente antes de la actualización, y si esta falla se revierte automáticamente, de modo que el sitio nunca queda a medio actualizar.

Acceder a Comprobar actualizaciones

Abra el menú izquierdo «Configuración del sistema → Comprobar actualizaciones» (/admin/about). La página muestra la versión actual, la hora de la última comprobación y el área de actualización del sistema.

Todos los administradores pueden abrir la página Comprobar actualizaciones, pero el área de actualización del sistema y las acciones de actualización solo se muestran y están disponibles para los superadministradores.

La antigua dirección /admin/settings/system/upgrade redirige automáticamente a /admin/about.

Comprobar actualizaciones

1. Haga clic en «Comprobar actualizaciones ahora».
2. La página muestra la hora de la última comprobación. Cuando se encuentra una nueva versión, se muestran el número de la nueva versión, la fecha de publicación y las notas de actualización; cuando no hay una nueva versión, se muestra «Ya está en la última versión».
3. La tarea programada del sistema comprueba automáticamente una vez al día. La comprobación automática solo lee la información de la versión y nunca actualiza automáticamente.

Si aparece «Clave pública de actualización no configurada; la actualización en línea no está disponible», un administrador del servidor debe configurar primero la clave pública de actualización. La actualización en línea no es posible hasta que se configure.

Actualización con un solo clic

Antes de comenzar, lea las advertencias de la página:

• Si se indica que algunos directorios o archivos no son escribibles, la actualización en línea fallará. Ajuste los permisos de escritura del directorio de código y del directorio data según las indicaciones y vuelva a comprobar.
• El sitio no estará disponible temporalmente para los visitantes durante la actualización. Se recomienda realizar la operación en horas de baja visita.

Pasos:

1. Confirme que la página muestra una nueva versión y lea las notas de actualización.
2. Haga clic en «Actualización con un solo clic» y confirme en el cuadro de confirmación.
3. La página muestra «Progreso de la actualización» y se actualiza automáticamente cada 3 segundos. El progreso muestra la versión de destino, el paso actual y el «Registro de ejecución».
4. El proceso de actualización se ejecuta en este orden: verificar la clave pública de actualización, descargar el paquete de actualización, verificar sha256, verificar la firma, comprobación del entorno, extraer, comprobar permisos de escritura, respaldar código y base de datos, comprobar archivos del tema, entrar en modo de mantenimiento, sobrescribir archivos, ejecutar migraciones de base de datos, limpiar la caché, salir del modo de mantenimiento, actualización completada.
5. Cuando el estado pasa a «Actualización completada», el front end vuelve a estar disponible. Actualice la página del panel de administración para confirmar que el número de versión ha cambiado.

Qué hacer si la actualización falla

• El sistema revierte automáticamente el código y la base de datos y sale del modo de mantenimiento. El progreso muestra «Actualización fallida» y «El código y la base de datos se han revertido automáticamente».
• Si la reversión automática falla, el sitio permanece en modo de mantenimiento y el registro de ejecución indica los directorios y archivos para la recuperación manual. Tras recuperarlos según el registro, haga clic en «Levantar mantenimiento» en la página.
• Si el proceso de actualización ha terminado pero la página sigue mostrando «El sitio sigue en modo de mantenimiento», confirme primero que la actualización se ha detenido y luego haga clic en «Levantar mantenimiento» y confirme.

Datos de países

El área «Datos de países» muestra la versión actual de los datos y se actualiza por separado de la actualización del sistema:

1. En el área «Actualización del sistema», busque «Datos de países».
2. Haga clic en «Actualizar datos de países» y confirme. El sistema descarga el archivo de datos de países más reciente desde el servidor de actualizaciones y verifica su hash.
3. Si tiene éxito, se muestra «Los datos de países se han actualizado a <versión>»; si falla, se muestra el motivo.

Puede actualizar los datos de países por separado aunque no necesite actualizar KingCMS en sí.

Archivos del tema

• La actualización comprueba si se han modificado los archivos del tema actual. Los archivos del tema modificados no se sobrescriben con la nueva versión; los archivos originales se respaldan en el directorio de datos y el registro de ejecución indica las rutas conservadas y las ubicaciones de respaldo.
• Si la versión actual no tiene manifiesto de tema, el sistema no puede determinar si los archivos se han modificado, por lo que primero respalda todos los archivos del tema y luego los sobrescribe con la nueva versión.

Por lo tanto, si ha publicado cambios en el tema con el «Editor de plantillas en línea», vuelva a comprobar el resultado del front end después de la actualización; las rutas de respaldo de los archivos conservados se escriben en el registro de ejecución.

Configuración de actualización

Abra «Configuración del sistema → Configuración → Seguridad y sistema → Configuración de actualización» (/admin/settings/system/update):

Después de cambiar el servidor de actualizaciones, vuelva a la página «Comprobar actualizaciones» y haga clic en «Comprobar actualizaciones ahora» para verificar que funciona.

Versión actual: X1.0.0-beta.3. Antes de actualizar, le recomendamos informarse sobre la copia de seguridad; después de actualizar, si necesita ajustar el sitio, consulte la Configuración inicial.