Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
sudo zylon-cli self-update
Verifica la versión antes de continuar:
sudo zylon-cli version
# Esperado: 2.0.0 o superior
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:
sudo zylon-cli list-versions
sudo zylon-cli install <version>
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:
The current drivers were uninstalled successfully, please REBOOT the system
and re-run the installation to complete the NVIDIA driver installation
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:
sudo reboot
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:
sudo zylon-cli install <version>
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:
sudo zylon-cli version
sudo kubectl get pods -A | grep triton
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:
sudo apt-get install --reinstall libc-bin
sudo zylon-cli install <version>
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:
sudo zylon-cli install <version> --no-packages --no-binaries
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.