デプロイ構成図

qOntology はフロントエンドとバックエンドを分離した構成です。Nginx がフロントエンドの配信とリクエストの転送を行い、qOntology API が業務処理を担当して MySQL、Redis、Neo4j などに接続します。標準構成では Docker Compose を使用して 1 台のサーバーにデプロイします。ファイルプレビューは kkFileView が提供し、AI モデルとベクトルサービスは必要に応じて接続します。

デプロイ構成図

実線は標準構成の接続、破線は任意の接続を表します。標準構成は 6 サービスです。AI モデルは別途設定が必要で、Weaviate は標準の Compose 構成に含まれないため、利用時に個別に用意します。

コンポーネント

コンポーネント	主な役割
Nginx	フロントエンドの静的リソースを配信し、API、WebSocket、ファイルプレビューのリクエストを各サービスに転送
qOntology API	基本管理、オントロジーモデリング、オントロジー応用の業務処理を担当し、データベース、キャッシュ、設定済みの外部サービスにアクセス
MySQL	システム設定と業務データを保存
Redis	キャッシュを提供
Neo4j	グラフデータを保存・検索し、エンティティと関係の読み書きを提供
kkFileView	オンラインでのファイルプレビューを提供
AI モデルサービス（任意）	有効化した AI 機能にモデル呼び出しを提供。利用可能なエンドポイントと認証情報が必要
Weaviate（任意）	ベクトルの保存・検索を提供。別途デプロイするか既存サービスに接続

アクセス経路

1. ページへのアクセス：ブラウザーで http://<SERVER_IP>:8897 を開くと、Nginx がフロントエンドのページと静的リソースを返します。入口ポートを変更した場合は、設定したポートを使用します。
2. 業務 API：フロントエンドは /prod-api で業務 API を呼び出し、/websocket/ でリアルタイム接続を確立します。Nginx は qontology-api:8097 に転送し、API は処理に応じて MySQL、Redis、Neo4j、任意の外部サービスにアクセスします。
3. ファイルプレビュー：ブラウザーは /kkfileview/ にプレビューを要求し、Nginx が kkfileview:8012 に転送します。プレビューサービスから対象ファイルの URL にアクセスできることも必要です。

これらのサービス名と内部ポートは Compose ネットワーク内の通信用です。ブラウザーは Nginx の入口を使用します。図は標準のシングルサーバー構成を示しており、本番環境ではリソースと可用性の要件に応じて、コンポーネントの分離、データ永続化、バックアップと復旧を計画してください。

Docker Compose のデプロイ手順を見る