Обновить приложение NocoBase

Область применения

Это руководство подходит для приложений, установленных через nb init. Если ваше приложение было установлено старым способом, сначала прочитайте Как обновить NocoBase с 2.0 до 2.1.

Шаг 1: проверьте текущий env

Сначала проверьте активный CLI env:

nb env current

Если вы не уверены, какие env доступны, сначала выведите список:

nb env list

Если текущий env не является приложением, которое нужно обновить, переключитесь на целевой env:

nb env use <env-name>

Шаг 2: выполните обновление

Примечание

По умолчанию при обновлении исходный код приложения или Docker-образ загружается заново.

Для npm / Git env каталог source/ удаляется и загружается заново. Не кладите в source/ файлы, которые нужно сохранить.

Если вы уже вручную подготовили исходный код или Docker-образ и не хотите, чтобы CLI загружал их повторно, добавьте к команде --skip-download.

Команда обновления по умолчанию:

nb app upgrade

Обычно эта команда выполняет следующие действия:

  1. Останавливает текущее приложение
  2. Загружает и заменяет сохраненный исходный код или образ
  3. Синхронизирует коммерческие плагины
  4. Обновляет и запускает приложение
  5. Обновляет runtime-информацию env

В скриптах, CI или сессиях AI Agent явно передавайте --force:

nb app upgrade --force

Если обновляемое приложение не является текущим env, укажите env:

nb app upgrade --env app1 --yes --force

Обновление до конкретной версии

Используйте --version, чтобы обновиться до конкретного канала версии:

nb app upgrade --version beta

Можно также указать точную версию:

nb app upgrade --version 2.1.0-beta.24

После успешного обновления CLI записывает целевую версию обратно в конфигурацию env, поэтому последующие обновления или восстановление смогут использовать эту информацию.

Пропустить загрузку

Если вы уже обновили исходный код или Docker-образ и хотите только выполнить upgrade и start на основе текущего содержимого, добавьте --skip-download:

nb app upgrade --skip-download

Этот параметр пропускает загрузку исходного кода или образа, а также синхронизацию коммерческих плагинов. Обычно его используют только тогда, когда целевая версия уже подготовлена вручную.

Шаг 3: проверьте результат

После обновления сначала проверьте runtime env и логи приложения:

nb env info
nb app logs

Затем откройте приложение и убедитесь, что учетная запись администратора может войти. Если AI Agent должен продолжить работу с этим приложением, запустите новую сессию AI Agent или перезапустите текущую, чтобы он прочитал свежую информацию env.

Связанные ссылки