Actualizar la aplicación NocoBase
Esta guía aplica a las aplicaciones instaladas con nb init. Si tu aplicación se instaló con el método antiguo, lee primero Cómo actualizar NocoBase de 2.0 a 2.1.
Paso 1: confirmar el env actual
Primero confirma el CLI env activo:
Si no tienes claro qué envs existen, lista primero todos:
Si el env actual no es la aplicación que quieres actualizar, cambia al env objetivo:
Paso 2: ejecutar la actualización
De forma predeterminada, la actualización descarga de nuevo el código fuente de la aplicación o la imagen Docker.
En envs npm / Git, el directorio source/ se elimina y se descarga de nuevo. No guardes ahí archivos que necesites conservar.
Si ya preparaste manualmente el código fuente o la imagen Docker y no quieres que la CLI los descargue de nuevo, añade --skip-download al comando.
El comando de actualización predeterminado es:
Este comando normalmente realiza estos pasos:
- Detener la aplicación actual
- Descargar y reemplazar el código o la imagen guardados
- Sincronizar plugins comerciales
- Actualizar e iniciar la aplicación
- Actualizar la información de runtime del env
En scripts, CI o sesiones de AI Agent, pasa --force explícitamente:
Si la aplicación que quieres actualizar no es el env actual, especifica el env:
Actualizar a una versión específica
Usa --version para actualizar a un canal de versión específico:
También puedes indicar una versión exacta:
Después de una actualización correcta, la CLI escribe la versión objetivo en la configuración del env, para que actualizaciones o recuperaciones posteriores puedan reutilizarla.
Omitir la descarga
Si ya actualizaste el código fuente o la imagen Docker y solo quieres ejecutar la actualización y el inicio con el contenido actual, añade --skip-download:
Este parámetro omite la descarga del código o la imagen y también omite la sincronización de plugins comerciales. Úsalo normalmente solo cuando la versión objetivo ya esté preparada manualmente.
Paso 3: verificar el resultado
Después de la actualización, revisa primero la información de runtime del env y los logs de la aplicación:
Luego abre la aplicación y confirma que la cuenta de administrador puede iniciar sesión. Si quieres que un AI Agent siga trabajando con esta aplicación, inicia una nueva sesión del AI Agent o reinicia la actual para que lea la información más reciente del env.
Enlaces relacionados
- Administrar aplicaciones — Iniciar, detener, reiniciar, ver logs y actualizar aplicaciones
- Referencia del comando
nb app upgrade— Ver todas las opciones del comando de actualización - Gestión de múltiples entornos — Confirmar, cambiar y mantener varios CLI envs