Hosting con 20% de descuento comprando por el enlace

Actualizar Velk

Lleva un sitio a una versión más nueva de Velk pidiéndolo. La IA descarga la versión oficial, la verifica, reemplaza solo el motor y conserva tu tema, tu contenido y tu configuración.

Un sitio Velk tiene dos partes. El motor es Velk en sí (core/, bin/, config/ y algunos archivos), igual en todos los sitios. Tu sitio es el resto: el tema, el contenido en la base de datos, los archivos subidos y el archivo .env, con contraseñas y claves. Actualizar cambia el motor por una versión publicada más nueva y deja tu sitio donde está.

No descargas nada. La IA lee qué versión usa el proyecto (registrada en .velk-version), busca la de destino en la lista oficial de releases.velkcms.com y espera tu aprobación antes de reemplazar un archivo.

Pídele a la IA

¿Hay una versión nueva de Velk? Dime qué versión usa este proyecto, cuál es la más reciente y qué cambia entre ambas que afecte a mi tema o a mi cliente.

Preguntar no cuesta nada: la respuesta te dice si es solo un cambio de archivos o si pide trabajo extra.

Pídele a la IA

Actualiza Velk en este proyecto a la última versión. Antes de reemplazar nada, muéstrame el plan: de qué versión a cuál, qué se reemplaza, qué se queda y qué cambio necesita mi tema.

La IA se detiene en el plan y espera tu sí.

Pídele a la IA

La copia de mi computadora ya está en la versión nueva y la revisé. Haz una copia de seguridad del sitio en línea y luego actualiza el motor del servidor a la misma versión.

En el servidor instala la versión publicada, nunca los archivos de tu computadora.

Qué hace la IA

  1. Lee las notas de actualización

    De cada versión entre la tuya y la de destino. Algunas piden más que archivos nuevos, y algunos de esos pasos tienen que ocurrir antes del cambio.

  2. Muestra el plan y espera

    De cuál a cuál, qué se reemplaza y qué se queda, los cambios en la base de datos, cualquier paso extra. Nada cambia antes de tu sí.

  3. Descarga y verifica

    Compara el archivo con el checksum publicado para esa versión (una huella del archivo). Si no coinciden, se detiene antes de abrirlo.

  4. Reemplaza solo el motor

    Copia lo que la versión nueva declara como motor y elimina los archivos del motor que la versión nueva ya no tiene.

  5. Ajusta la base de datos

    Ejecuta bin/velk migrate (las migraciones son los pasos que ajustan la base de datos a la versión nueva). Solo si todas salen bien borra migrations/.

  6. Registra e informa

    Escribe la versión nueva en .velk-version, junto con la anterior, y te dice qué cambió y cómo volver atrás.

Qué se reemplaza y qué se queda

ParteAl actualizar
El motor: core/, config/, bin/, migrations/, index.php, los archivos de ejemplo y la documentación del propio motorSe reemplaza por la versión nueva
theme/: estructura, plantillas (los archivos que dibujan las páginas), diseñoSe queda
La base de datos: contenido, configuración, usuarios, envíos de formulariosSe queda, solo la ajustan las migraciones
storage/: archivos subidos y registrosSe queda
.env, el .htaccess y el robots.txt del sitio, tu .gitignoreSe quedan
Lo que ejecuta la IA
# la versión más reciente, y la huella de su archivo $ curl -fsSL https://releases.velkcms.com/versions.json $ shasum -a 256 velk-v3.9.1.tar.gz # una vez reemplazados los archivos del motor $ ./bin/velk migrate $ ./bin/velk schema:validate ✓ site.json is valid. # en el sitio en línea, después de tu sí $ scripts/deploy/update-cms.sh --project . ✓ Engine synced ✓ Migrations OK ✓ HTTP 200 OK
En el servidor, update-cms repite las verificaciones y termina confirmando que la página de inicio responde.

Versiones que piden más que archivos nuevos

La mayoría de las actualizaciones son un cambio de archivos. Algunas piden un cambio en el tema o en site.json, a veces antes de que llegue el motor nuevo. La skill guarda estas notas de actualización, y la IA suma al plan lo que piden. Dos casos recientes:

  • v3.9.0 agregó una función richtext al motor. Una función del tema con ese nombre detendría todas las páginas, así que la IA la renombra antes.
  • v3.8.4 llevó la configuración de la política de seguridad (la CSP) del .env al site.json. En un sitio que la usaba, la IA la pasa a site.json y publica el tema antes de actualizar el servidor.

El número de versión engaña: la v3.7.1, que por el número parece una corrección menor, exigió que cada tema escribiera sus propios mensajes de formularios y de inicio de sesión. Actualizar pidiéndolo es lo que hace que estos pasos ocurran.

De tu computadora al sitio en línea

Con una copia completa del sitio en tu computadora, la IA actualiza esa copia primero. La revisas en el navegador y luego pides el servidor: update-cms instala la misma versión publicada, con las mismas verificaciones, y confirma que la página de inicio responde. Sin copia local, la IA actualiza el servidor directamente e indica la versión.

Se niega a actualizar un servidor sin Velk (ahí corresponde un primer despliegue) y a poner una versión más antigua sobre una más nueva, porque la base de datos ya tiene una estructura que el código antiguo no conoce.

Hosting sin SSH

Algunos hostings no tienen SSH (la conexión segura que la IA usa para ejecutar comandos en un servidor), solo FTP (la transferencia de archivos que ofrecen la mayoría de los paneles de hosting). Ahí los archivos del motor se suben por FTP: pídele a la IA que descargue y verifique la versión y que te diga exactamente qué subir, y nunca subas el .env de tu computadora, que apunta a tu base de datos local. En la primera visita después de subirlos, Velk aplica las migraciones por su cuenta (AUTO_MIGRATE, activado por defecto).

La página de mantenimiento

En cualquier actualización, quien llega mientras corren las migraciones ve una página simple que dice “Atualizando…” (“Actualizando…”, en portugués) y se recarga sola en pocos segundos. Si una migración falla, dice “Atualização falhou” (“La actualización falló”) y se queda así hasta que alguien lo resuelva.

El motivo está en storage/cache/migration-error.json y storage/logs/migration.log, que también se leen por FTP. Una vez corregida la causa, bin/velk migrate (por SSH, o como tarea programada en el panel del hosting) aplica lo que falta y devuelve el sitio. Más en Solución de problemas.

Después de actualizar

  • bin/velk schema:validate pasa. Desde la v3.9.0 también lista, en “Warnings:”, plantillas que le faltan al tema; esas direcciones dan 404.
  • La página de inicio y una página interna abren, y el panel te deja entrar.
  • Un formulario de prueba muestra su mensaje. Una caja vacía significa que el tema no le pone palabras a un código que usa la versión nueva.
  • En un sitio multi-idioma, abre algunas páginas traducidas: la v3.9.0 y la v3.9.1 cambiaron lo que muestran cuando una traducción está en blanco.

La carpeta migrations/ ahora parece vacía. Es normal: los archivos se borran una vez aplicados, y la base de datos guarda el registro de lo que se ejecutó. bin/velk migrate:status lo avisa en lugar de decir que todo está aplicado.