オープンソース版のデプロイ
qOntology オープンソース版は、オントロジーモデリング、セマンティック資産管理、オントロジー応用などの機能を提供します。評価、開発、運用の要件に応じてデプロイ方式を選択してください。
| 方式 | 実装方法 | 適用場面 |
|---|---|---|
| Docker Compose によるデプロイ | リポジトリの Compose ファイルを使用し、フロントエンドと設定を準備してからアプリケーションとミドルウェアを段階的に起動 | 1 台構成での試用、デモ、検証、運用担当者が管理するシングルサーバー環境 |
| ソースコードからローカル起動 | バックエンドとフロントエンドをローカルで実行し、データベース、キャッシュ、その他の依存サービスを別途準備 | 日常開発、結合検証、カスタマイズ |
| 手動デプロイ | 実行環境とミドルウェアを個別にインストールし、バックエンドとフロントエンドの成果物を配置 | 既存インフラ、コンポーネントの分離配置、独自のネットワーク・運用環境 |
初めて試す場合は Docker Compose によるデプロイから始めてください。リポジトリには Compose ファイルがありますが、同一リリースのフロントエンド dist とデプロイ設定は別途準備が必要です。汎用的なワンクリックインストーラーはありません。
Docker Compose によるデプロイ
リポジトリの docker/ ディレクトリには、qOntology API、Nginx、MySQL、Redis、Neo4j、kkFileView の構成定義があります。標準のデータベースは MySQL、システムの入口ポートは 8897 です。
デプロイの流れ：プロジェクトと対応イメージを入手 → フロントエンドを準備 → パスワードとデータマウントを設定 → ミドルウェアを起動 → API と Nginx を起動 → ログインを確認。
- デプロイ先へのバックエンド用 JDK／Maven のインストールは不要です。フロントエンドを自分でビルドする場合は Node.js と npm を用意します。
docker compose -p qontology --profile allでサービスを管理し、同じデプロイディレクトリからログと状態を確認します。- 現在の構成はシングルサーバー向けです。本番運用ではデータ量、バックアップ、アクセス制御、可用性の要件に応じて運用構成を設計してください。
ソースコードからローカル起動
コードの変更、ブレークポイントによるデバッグ、フロントエンドとバックエンドの結合確認を行う開発者向けです。
- バックエンドは JDK 17 と Maven 3.8+ を使用し、
qontology-serverから起動します。 - フロントエンドは Node.js 18+ と npm を使用し、
qontology-uiで依存関係をインストールして開発サーバーを起動します。 - MySQL、Redis、および利用する機能が必要とする Neo4j、kkFileView を準備します。既存サービスやコンテナーを利用できます。
- 開発設定の接続先、アカウント、ポート、フロントエンドのプロキシを確認してください。Compose ネットワーク内でしか解決できないサービス名をそのまま使用しないでください。
プロジェクトの README.md と QUICKSTART.md にソースからの実行方法が記載されています。具体的なバージョンは現在の POM、フロントエンドのマニフェスト、実際の設定を基準にしてください。現在の Compose に専用の local プロファイルはありません。他製品の起動方式をそのまま適用しないでください。
ソースコード：qOntology の Gitee リポジトリ。
手動デプロイ
運用担当者が JDK、データベース、キャッシュ、グラフデータベース、プレビューサービス、Nginx を個別にインストールし、バックエンド JAR とフロントエンド dist を配置します。
既存のデータベース、共通ゲートウェイ、バックアップ基盤を再利用でき、アプリケーションとミドルウェアを別ホストに配置することも可能です。サービスのアドレス、起動順序、プロセス管理、ログ、データディレクトリ、復旧手順は個別に管理する必要があります。
Compose と比較すると、手動デプロイでは環境設定と継続的な保守の作業が増えます。中国国産 OS・データベースや ARM ホストを使用する場合は、対象の組み合わせの動作条件を確認してから、機能と安定性を検証してください。
デプロイ前の準備
| 準備項目 | 確認内容 |
|---|---|
| バージョンの整合性 | ソースコード、バックエンドのイメージまたは JAR、フロントエンド、設定、初期化 SQL を同一リリースで統一 |
| ネットワークとリソース | イメージや依存関係を取得でき、実際のデータ量と同時実行数に対応するホストリソースがあり、必要なポートが未使用 |
| アカウントと設定 | データベース、キャッシュ、アプリケーションに個別の認証情報を設定し、接続先とアクセス入口を確認 |
| データと復旧 | データベースとアップロードファイルの永続化先を決め、既存データをバックアップ。初期化スクリプトで業務環境を上書きしない |
デプロイ後は、少なくともログイン、プロジェクト検索、ファイルのアップロード・ダウンロード、プレビューを確認してください。グラフと AI の機能は、実際に有効化した範囲に応じて個別に検証します。