Core

Core · マルチアプリアーキテクチャ · マルチアプリケーション

概要

マルチアプリが適している場面

業務システムを個別に開発・リリース・運用しながら、共通の入口とアカウントで利用したい場合に使います。たとえば、顧客管理と在庫管理のデータやバージョンを分離し、メインアプリのワークベンチからアクセスできます。

同じアプリ内でページやナビゲーション、ユーザー向けの入口を分ける場合は、マルチポータルを検討してください。マルチアプリでは、インスタンスごとのデータベースと運用が必要です。

補足

このガイドは新しいマルチアプリのデプロイ管理を対象とします。利用する配布元に、互換性のある multi-app、sub-app テンプレートとプロジェクト用デプロイ CLI が公開されていることを確認してください。ソース候補の機能が公開パッケージに含まれるとは限りません。旧 Releases の設定・操作手順は適用できません。

メインアプリ、子アプリ、アプリインスタンス

用語役割
メインアプリ(Main)ワークベンチ、プラットフォームアカウント、SSO、デプロイ管理を提供
子アプリ独自のコード、依存関係、バージョンを持つ業務プロジェクト
アプリインスタンスあるバージョンを配置した実体。個別の設定、データ、URL を持つ

メインアプリを作成しても、子アプリは自動作成されません。同じ子アプリを複数のインスタンスとして配置できます。名前は表示用で、インスタンス ID は識別とアクセスパスに使われます。

ビルド成果物、バージョン、実行ノード

子アプリをビルドするとデプロイアーカイブが生成され、アップロードによりアプリパッケージの変更不可のバージョンとして公開されます。実行ノードはデプロイ操作を実行し、インスタンスを動かします。

流れは 子アプリのプロジェクト → ビルド成果物 → 公開バージョン → 実行ノード上のインスタンス です。公開だけではインスタンスの作成や更新は行われません。

現在は、同じマシン上で独立した App Host プロセスを起動するローカル実行ノードに対応しています。ノードは Main の設定で定義し、起動時に自動開始します。ノード画面は設定と状態の確認用です。リモートマシンの登録や Docker オーケストレーションは、この手順の対象外です。

データ分離、SSO、業務権限

インスタンスごとに業務データ、設定、秘密情報、ファイルを管理します。同じデータベースサーバーを使う場合も、データベースまたは名前空間を分離してください。開発用データベースやアップロードファイル、インスタンスの秘密情報は成果物に含めません。

SSO は有効なプラットフォームユーザーの本人確認を行いますが、Main のロールを子アプリにコピーしません。Main の管理者も子アプリの管理者には自動でなりません。SSO と業務権限を参照してください。

Main とプラグインの役割

Main テンプレートはシェル、システム設定、プラグイン構成を提供します。Deployment は成果物、バージョン、ノード、インスタンス、デプロイ操作を担当します。Multi-app は管理画面、ワークベンチ、プラットフォーム接続を担当します。Identity Provider と子アプリの Platform SSO が統一ログインを提供します。

テンプレートでは必要な統合が済んでいます。既存アプリでは、そのアプリの構成に合わせた統合が必要です。ログイン URL のコピーだけでは完了しません。

ワークベンチとデプロイ管理

一般ユーザーは Workbench からアプリを開きます。権限を持つ管理者は System settings → Deployment management を使います。

入口操作
Application instances作成、設定、更新、運用、既存アプリの接続
Build artifactsアーカイブのアップロードとバージョン管理
Runtime nodes設定、利用可否、実行要件の確認
Deployment records進捗、承認、ログの確認

デプロイ管理権限と子アプリの業務権限は別です。

ワークベンチから、ログイン中のユーザーが利用できるアプリを開きます。
ワークベンチから、ログイン中のユーザーが利用できるアプリを開きます。
System settings の Deployment management に、インスタンス、成果物、実行ノード、デプロイ記録がまとまっています。
System settings の Deployment management に、インスタンス、成果物、実行ノード、デプロイ記録がまとまっています。

前提条件

Node.js 24 以降、テンプレートに対応する pnpm、商用パッケージのダウンロード権限が必要です。Main には安定した URL、独立したデータベース、永続ストレージを用意します。実行ノードは成果物の OS、CPU、libc、Node.js 要件を満たす必要があります。

初回はクイックスタート、既存システムには既存アプリの接続を使ってください。

NocoBase ドキュメントアシスタント

NocoBase について何を知りたいですか?

質問は個別に回答され、過去の質問や回答は参照されません。必要な背景をすべて含めてください。