#多アプリケーション

#紹介

**多アプリケーションプラグイン（Multi-app）**は、個別にデプロイすることなく、複数の独立したアプリケーションを動的に作成・管理できるようにします。各サブアプリケーションは完全に独立したインスタンスであり、独自のデータベース、プラグイン、設定を保持します。

#利用シーン

• マルチテナント：独立したアプリケーションインスタンスを提供し、顧客ごとに独自のデータ、プラグイン設定、権限体系を構築できます。
• 異なるビジネスドメインのメイン・サブシステム：大規模なシステムを、独立してデプロイされた複数の小規模なアプリケーションで構成します。

#インストール

プラグインマネージャーで**多アプリケーション（Multi-app）**プラグインを見つけ、有効化します。

#ユーザーマニュアル

#サブアプリケーションの作成

システム設定メニューの「多アプリケーション」をクリックし、管理画面に移動します。

「新規追加」ボタンをクリックして、新しいサブアプリケーションを作成します。

#フォーム項目の説明

• 名称：サブアプリケーションの識別子。グローバルで一意である必要があります。
• 表示名：インターフェース上に表示されるサブアプリケーションの名前。
• 起動方法：
  • 初回アクセス時に起動：ユーザーが初めて URL 経由でアクセスしたときに起動します。
  • メインアプリと同時に起動：メインアプリケーションの起動時にサブアプリケーションも起動します（メインアプリの起動時間が長くなります）。
• ポート：サブアプリケーションが実行時に使用するポート番号。
• カスタムドメイン：サブアプリケーションに独自のサブドメインを設定します。
• メニューに固定：サブアプリケーションへの入り口をトップナビゲーションバーの左側に固定表示します。
• データベース接続：サブアプリケーションのデータソースを設定します。以下の3つの方式をサポートしています：
  • 新しいデータベース：現在のデータサービスを再利用し、独立したデータベースを作成します。
  • 新しいデータ接続：全く新しいデータベースサービスを設定します。
  • スキーマモード：PostgreSQL 内にサブアプリケーション用の独立したスキーマを作成します。
• アップグレード：接続先のデータベースに古いバージョンの NocoBase データ構造が存在する場合、自動的に現在のバージョンにアップグレードされます。

#サブアプリケーションの実行と停止

起動ボタンをクリックするとサブアプリケーションが起動します。

作成時に*「初回アクセス時に起動」*にチェックを入れた場合、最初のアクセス時に自動的に起動します。

表示ボタンをクリックすると、新しいタブでそのサブアプリケーションが開きます。

#サブアプリケーションの実行ステータスとログ

リストで各アプリケーションのメモリとCPUの使用状況を確認できます。

ログボタンをクリックすると、サブアプリケーションの実行ログを確認できます。

起動後にアクセスできない場合（データベースの破損など）、ログを確認して原因を調査できます。

#サブアプリケーションの削除

削除ボタンをクリックするとサブアプリケーションを削除できます。

削除時にデータベースも一緒に削除するかどうかを選択できます。この操作は取り消せないため、注意して実行してください。

#サブアプリケーションへのアクセス

デフォルトでは /_app/:appName/admin/ を使用してアクセスします。例：

http://localhost:13000/_app/a_7zkxoarusnx/admin/

また、サブアプリケーションに独自のサブドメインを設定することも可能です。ドメインを現在のIPアドレスに解決し、Nginxを使用している場合はNginxの設定にもドメインを追加する必要があります。

#コマンドラインによる管理

プロジェクトのルートディレクトリで、PM2 を使用してサブアプリケーションのインスタンスを管理できます。

yarn nocobase pm2 list              # 実行中のインスタンス一覧を表示
yarn nocobase pm2 stop [appname]    # 特定のサブアプリケーションプロセスを停止
yarn nocobase pm2 delete [appname]  # 特定のサブアプリケーションプロセスを削除
yarn nocobase pm2 kill              # すべての起動済みプロセスを強制終了（メインアプリのインスタンスを含む場合があります）

#旧バージョンの多アプリケーションデータの移行

旧バージョンの管理画面に移動し、**「新しい多アプリケーションへデータを移行」**ボタンをクリックして移行を実行します。

#よくある質問

#1. プラグイン管理

サブアプリケーションで使用できるプラグインはメインアプリと同じ（バージョンを含む）ですが、個別に設定・使用することが可能です。

#2. データベースの分離

サブアプリケーションごとに独立したデータベースを設定できます。アプリケーション間でデータを共有したい場合は、外部データソースを使用して実現できます。

#3. データのバックアップと移行

現在、メインアプリでのバックアップにはサブアプリケーションのデータは含まれません（基本情報のみ含まれます）。各サブアプリケーション内で手動でバックアップと移行を行う必要があります。

#4. デプロイと更新

サブアプリケーションのバージョンはメインアプリのアップグレードに自動的に追従し、メイン・サブアプリケーション間のバージョンの一致が保証されます。

#5. リソース管理

各サブアプリケーションのリソース占有量はメインアプリとほぼ同じです。現在、1つのアプリケーションあたりのメモリ使用量は約500〜600MBです。