古いインストール方法を AI に接続し、CLI に移行する方法

古いドキュメントに従って NocoBase のインストールと保守に Docker、create-nocobase-app、または Git ソース コードをまだ使用している場合は、この方法で引き続き使用できます。 AI にアクセスするためにアプリケーションをすぐに再インストールする必要はありません。

このページは主に、最初にルートを決定するのに役立ちます。

  • 元のインストールおよびアップグレード方法を引き続き使用します
  • 既存のアプリケーションが最初に AI エージェントにアクセスできるようにする
  • 新しい CLI ベースのアプローチへの移行

デフォルトでは、まず自分がどのカテゴリに属しているかを確認してから、対応するドキュメントを入力することをお勧めします。これはより安定しており、実稼働環境で誤動作する可能性が低くなります。

どの方法を選択すればよいでしょうか?

今すぐご希望の場合は...デフォルトで何をするか
元の方法でアプリケーションのインストール、アップグレード、保守を続行引き続き古い方法を使用してください。まず、以下の関連するドキュメントのエントリを読んでください。
安定して実行されている古いアプリケーションを AI エージェントに接続させます。デフォルトでは、リスクが最も低いリモート接続が最初に使用されます。
今後、アプリケーションを管理するには nb appnb envnb source を使用してください新しい CLI アプリケーションを作成し、そこに古いデータを移行します。

元のインストール方法を引き続き使用します

以前のインストール方法に慣れている場合は、引き続きそれを使用できます。インストール、アップグレード、環境変数の設定については、元のドキュメントに従ってください。

NocoBase をインストールする

NocoBase をアップグレードする

方法 1: まず既存のアプリケーションが AI エージェントにアクセスできるようにします

古いアプリケーションがすでに安定して実行されている場合は、デフォルトでこの方法を使用します。

この方法の焦点は、最初にリモート接続を通じて既存のアプリケーションを CLI および AI エージェントに接続することです。現在のインストール、起動、停止、アップグレードのプロセスを直接引き継がないため、これは最もリスクが低くなります。

しかし、最初に境界を明確にする必要があります。

  • このメソッドには nb app 関連の機能がありません
  • 古いアプリのランタイム管理を引き継ぎません。
  • ただし、AI構築関連の能力は通常通り使用できます

つまり、現時点で最も重視しているのが「運用管理システム全体を直ちに CLI に切り替える」ことではなく、「まず AI を接続する」ことである場合、デフォルトではこのパスを最初に選択することになります。

既存のアプリケーションに接続するときは、次のように CLI 環境を初期化できます。

# 默认使用 OAuth 认证
nb init --yes --env app1 \
  --api-base-url=http://your-app-host/api

# 使用 token 认证
nb init --yes --env app1 \
  --api-base-url=http://your-app-host/api \
  --auth-type=token \
  --access-token=<token>

後で再認証が必要な場合は、次を実行できます。

nb env auth app1

AI を使用して機能を構築したい場合は、AI Build Quick Start を読み続けてください。

方法 2: CLI に移行する

将来、nb appnb env、および nb source を使用してローカル アプリケーションを管理する場合、より安全な方法は、既存のアプリケーションを直接引き継ぐのではなく、新しいアプリケーションを作成し、そこに古いアプリケーションのデータを移行することです。

理由も非常に単純で、「既存のアプリケーションを引き継ぐ」機能がまだ開発中であるためです。

したがって、現時点でのデフォルトの推奨移行ルートは次のとおりです。

  1. まず新しい CLI アプリケーションを作成します
  2. データベース、storage、および古いアプリケーションの環境変数を移行します。
  3. 新しいアプリケーションの動作、アップグレード、AI 機能が正常であることを確認した後、運用環境に切り替えるかどうかを決定します。

まず新しい CLI 環境を作成します。

nb init --yes --env app1

移行する前に、次のコンテンツの準備ができていることを確認することをお勧めします。

  1. データベースはバックアップされています
  2. storage ディレクトリがバックアップされました
  3. APP_KEYTZDB_*DB_UNDERSCORED など、古いアプリケーションの主要な環境変数が記録されています。

デフォルトでは、最初にテスト環境を移行するだけで十分です。バックアップ、環境変数、データベース構成がすべて正しいことを確認した場合にのみ、実稼働環境を移行してください。

次にどこを見るべきか

  • 新しい方法でアプリケーションをインストールおよび管理する準備ができている場合は、CLI を使用したインストール (推奨) に進みます。
  • 元のインストール方法をそのまま使用し続ける場合は、上記のインストールとアップグレードのドキュメント エントリに戻ってください。