NocoBase アプリをアップグレード
このガイドは nb init でインストールしたアプリ向けです。古い方法でインストールしたアプリの場合は、先に NocoBase を 2.0 から 2.1 へアップグレードする方法 を確認してください。
ステップ 1: 現在の env を確認する
まず、現在有効な CLI env を確認します。
利用可能な env が分からない場合は、先に一覧を確認します。
現在の env がアップグレード対象のアプリでない場合は、対象 env に切り替えます。
ステップ 2: アップグレードを実行する
デフォルトでは、アップグレード時にアプリのソースコードまたは Docker イメージが再ダウンロードされます。
npm / Git env の場合、source/ ディレクトリは削除されてから再ダウンロードされます。保持したいファイルを source/ に置かないでください。
ソースコードまたは Docker イメージをすでに手動で準備していて、CLI に再ダウンロードさせたくない場合は、コマンドに --skip-download を追加します。
デフォルトのアップグレードコマンドは次のとおりです。
このコマンドは通常、次の処理を行います。
- 現在のアプリを停止する
- 保存済みのソースまたはイメージをダウンロードして置き換える
- 商用プラグインを同期する
- アプリをアップグレードして起動する
- env の runtime 情報を更新する
スクリプト、CI、AI Agent セッションで実行する場合は、--force を明示的に指定します。
アップグレード対象のアプリが現在の env でない場合は、env を指定します。
特定バージョンへアップグレードする
特定のバージョンチャネル にアップグレードするには --version を使います。
具体的なバージョン番号も指定できます。
アップグレードに成功すると、CLI は対象バージョンを env 設定に書き戻します。以後のアップグレードや復旧フローでもそのバージョン情報を利用できます。
ダウンロードをスキップする
ソースコードまたは Docker イメージをすでに更新済みで、現在の内容を使ってアップグレードと起動だけを行いたい場合は、--skip-download を追加します。
このパラメータはソースまたはイメージのダウンロードをスキップし、商用プラグインの同期もスキップします。通常は、対象バージョンを手動で準備済みの場合にのみ使用します。
ステップ 3: 結果を確認する
アップグレード後は、まず env runtime とアプリログを確認します。
その後アプリを開き、管理者アカウントでログインできることを確認します。AI Agent にこのアプリの操作を続けさせる場合は、新しい AI Agent セッションを開始するか、現在のセッションを再起動して、最新の env 情報を読み込ませることをおすすめします。
関連リンク
- アプリを管理する — アプリの起動、停止、再起動、ログ確認、アップグレード
nb app upgradeコマンドリファレンス — アップグレードコマンドの全オプションを確認する- 複数環境の管理 — 複数の CLI env を確認、切り替え、管理する