Actualización a 1.57

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.

Antes de empezar: identifica los modelos de 1.57

Consulta ai.preset en /etc/zylon/zylon-conf.yaml en la máquina que vas a actualizar. Busca ese preset en la Referencia de Presets de IA de 1.57; la columna Modelos enumera los IDs que necesitas, incluido el modelo de embeddings. Si usas un preset personalizado, utiliza los IDs de su configuración. Sustituye <model_id> en esta guía por uno de esos IDs. Repite cada comando de descarga para todos los modelos que necesita tu preset. En una instalación totalmente aislada, usa los mismos IDs en la máquina online y en la offline. Esta guía actualiza a 1.57: utiliza la referencia de 1.57 enlazada aunque estés leyendo la documentación de la próxima versión.

Paso 1: Descarga el modelo y actualiza

Sigue los pasos según tu tipo de instalación.

Online
Semi-Airgap
Airgap Completo

Actualiza la CLI (obligatorio)

sudo zylon-cli self-update

Si el comando falla o la versión no cambia, ejecuta el instalador de respaldo:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Descarga el modelo

Usa los IDs identificados antes de estos pasos; descarga cada modelo necesario.

sudo zylon-cli models download <model_id>

Instala 1.57

sudo zylon-cli list-versions
sudo zylon-cli install 1.57.X

Para detalles completos del entorno y troubleshooting, consulta la guía de actualización online.

Actualiza la CLI (obligatorio)

sudo zylon-cli self-update

Si el comando falla o la versión no cambia, ejecuta el instalador de respaldo:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Rehabilita acceso a internet

Permite temporalmente operaciones online en la configuración y aplícalo:

airgap:
  offlineOperation: false

sudo zylon-cli sync

Verifica conectividad

sudo zylon-cli preflight --network -v

Descarga el modelo

sudo zylon-cli models download <model_id>

Instala 1.57

sudo zylon-cli list-versions
sudo zylon-cli install 1.57.X

Vuelve a activar modo offline

airgap:
  offlineOperation: true

sudo zylon-cli sync

Para red/proxy y más detalle operativo, consulta la guía de actualización semi-airgap.

Estos pasos se ejecutan en dos máquinas: una con internet para descarga y la máquina destino offline.

Máquina online: actualiza la CLI (obligatorio)

sudo zylon-cli self-update

Si el comando falla o la versión no cambia, ejecuta el instalador de respaldo:

curl -sL get.zylon.ai | sudo -E bash

sudo zylon-cli version

Máquina online: descarga y exporta el modelo

sudo zylon-cli models download --no-install <model_id>
sudo zylon-cli models export

Máquina online: prepara el paquete de transferencia de la CLI

sudo tar -czf zylon-update.tar.gz \
  /usr/local/bin/zylon-cli \
  /usr/local/bin/zylon-forge-cli

Máquina online: exporta el bundle de plataforma 1.57

sudo zylon-cli list-versions

# Usa --from si conoces tu versión actual (bundle más pequeño)
sudo zylon-cli export 1.57.X --from CURRENT_VERSION

# Si no, exporta un bundle completo
sudo zylon-cli export 1.57.X

Transfiere artefactos a la máquina offline

Transfiere los archivos necesarios:

zylon-models-*.tar
zylon-*.tar
zylon-update.tar.gz

Máquina offline: extrae el paquete de actualización CLI

cd /tmp
sudo tar -xzf zylon-update.tar.gz -C /
sudo chmod +x /usr/local/bin/zylon-cli /usr/local/bin/zylon-forge-cli
sudo zylon-cli version  # Debería mostrar 2.6.3 o posterior

Máquina offline: importa e instala

# Importa el modelo y luego instálalo en runtime offline
sudo zylon-cli models import zylon-models-*.tar
sudo zylon-cli models download --offline <model_id>

# Importa el bundle de Zylon, verifica la versión y luego instala
sudo zylon-cli import zylon-*.tar
sudo zylon-cli list-versions --offline
sudo zylon-cli install 1.57.X --airgap

Para bundles diferenciales y transferencia, consulta la guía de actualización airgap.

​Antes de empezar: identifica los modelos de 1.57

​Paso 1: Descarga el modelo y actualiza

Antes de empezar: identifica los modelos de 1.57

Paso 1: Descarga el modelo y actualiza