Skip to main content
Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.
Esta guía es obligatoria antes de actualizar a Zylon 1.53.0 o cualquier versión posterior. Omitir estos pasos causará que Triton no pueda arrancar y puede romper el acceso existente a los tokens de API.

​
Resumen

Esta guía te lleva a través del ciclo completo de actualización en tres fases:
  • Pre-actualización — realiza una copia de seguridad de tu instancia y actualiza la CLI
  • Actualización — reconfigura e instala la nueva versión de la plataforma
  • Post-actualización — migra los tokens de API al nuevo sistema de Gateway (obligatorio para acceder a la API de ZylonGPT)
Planifica aproximadamente 45–60 minutos de tiempo total de actualización, incluyendo ~35 minutos de inactividad de GPU durante los cuales la inferencia no estará disponible. Notifica a tus usuarios antes de comenzar.

​
¿Necesito la migración de tokens?

Solo uso endpoints de Workspace

No te ves afectado por los cambios de tokens. Completa los pasos de actualización de la plataforma y omite la sección de post-actualización.

Uso la API de ZylonGPT (o planeo usarla)

Los tokens generados antes de v1.54 solo funcionarán como tokens de Workspace y no podrán llamar a /api/gpt/v1/*. Debes completar la migración de tokens post-actualización.

​
Pre-actualización

1

Realiza una copia de seguridad de tu instancia

Toma una copia de seguridad completa de tu instancia antes de realizar cualquier cambio. La actualización solo afecta la capa de plataforma y los drivers — tu base de conocimiento, chats, flujos de agentes y configuración no se verán afectados — pero se recomienda encarecidamente hacer una copia de seguridad.
2

Actualiza la CLI a 2.0.0

Ejecuta la auto-actualización de la CLI para obtener Zylon CLI 2.0.0:
Verifica la versión antes de continuar:
No continúes hasta que la CLI esté en la versión 2.0.0 o superior. Instalar v1.53.0+ con una CLI más antigua resultará en una instalación dañada.

​
Actualización

1

Reconfigura tu instancia

v1.53.0 requiere que regeneres tu archivo de configuración. Elige una de las siguientes opciones:
  1. Asistente interactivo — ejecuta sudo zylon-cli config init y sigue las instrucciones.
  2. Regeneración silenciosa — ejecuta sudo zylon-cli config init -y para regenerar sin asistente.
2

Inicia la instalación

Lista las versiones disponibles e instala la versión que deseas:
A partir de v1.53.0, cada versión incluye sus propias dependencias — incluyendo paquetes Apt, binarios y drivers — de modo que obtienes el entorno exacto requerido para esa versión. Esta versión también actualiza a CUDA 13.0.
La instalación se detendrá intencionalmente con el siguiente mensaje después de desinstalar los drivers NVIDIA existentes:
Este es el comportamiento esperado. Procede al siguiente paso para reiniciar antes de continuar.
3

Reinicia el sistema

Después de ver el mensaje de desinstalación, reinicia:
Esto es necesario antes de que los nuevos drivers de CUDA 13.0 puedan instalarse.
4

Completa la instalación

Una vez que el sistema haya vuelto a arrancar, vuelve a ejecutar el comando de instalación:
La instalación ahora se completará correctamente con los nuevos drivers de CUDA 13.0.
De aquí en adelante, usa siempre sudo zylon-cli install <version> para actualizar. El comando sudo zylon-cli update sigue existiendo pero ya no gestiona las actualizaciones de versión a partir de v1.53.0 — ahora actúa como sudo zylon-cli sync.

​
Post-actualización: Migrar tokens de API

Omite esta sección si no estás usando la API de ZylonGPT (/api/gpt/v1/*).
Los tokens generados antes de v1.54 solo funcionan como tokens de Workspace. Para llamar a los endpoints de ZylonGPT, necesitas un token de Gateway.
1

Crea un Gateway

Inicia sesión con tu cuenta admin@zylon.ai y crea un nuevo Gateway en el Backoffice. Ir a Backoffice → Gateways
Solo la cuenta admin@zylon.ai tiene permisos para crear Gateways por defecto. Cualquier operador con el rol Operator asignado en el Backoffice también puede crear Gateways.
2

Añade miembros al Gateway

Una vez creado el Gateway, añade los usuarios que necesiten acceso como miembros con rol Developer.
Solo los usuarios con el rol Developer pueden ser añadidos a un Gateway. Si un usuario aún no es Developer, asciéndelo primero en Gestión de Cuentas antes de añadirlo aquí.
3

Genera un nuevo token de Gateway

  1. Inicia sesión con tu cuenta de usuario (no la cuenta de administrador).
  2. Abre Developer Console y selecciona tu Gateway.
  3. Haz clic en Create API Token, asígnale un nombre y genera el token.
  4. Copia el secreto del token — se muestra solo una vez.
Ahora puedes usar este token para acceder a todos los endpoints de ZylonGPT (/api/gpt/v1/*). Consulta la documentación completa de gestión de tokens para más detalles.

​
Resolución de problemas

La causa más probable es que la CLI no se actualizó a 2.0.0 antes de ejecutar la instalación. Verifica:
Si la CLI es anterior a 2.0.0 y Triton no muestra 1/1 READY, sigue los pasos de recuperación de esta guía desde el principio, comenzando con la auto-actualización de la CLI.
Detén el comando de instalación actual, reinstala manualmente el paquete problemático y vuelve a intentarlo:
Reinicia la máquina y vuelve a intentarlo. Si el problema persiste, contacta con el soporte de Zylon. También puedes ejecutar una verificación más rápida omitiendo paquetes y binarios:
Los tokens generados antes de v1.54 solo funcionan como tokens de Workspace. Si estás llamando a endpoints /api/gpt/v1/*, sigue los pasos de Post-actualización: Migrar tokens de API descritos arriba para crear un Gateway y generar un nuevo token de Gateway.