環境のセットアップ

本ページは手動デプロイの手順 1 です。例では Ubuntu 22.04 x86_64 を使用します。sudo 権限と公式ソフトウェアリポジトリへのネットワーク接続が必要です。他のディストリビューションや ARM ホストに、同じパッケージ名をそのまま適用することはできません。

バージョン要件

コンポーネント	使用バージョン	用途とインストール先
OpenJDK	17	qOntology API・Neo4j・kkFileView 実行サーバー、バックエンド・kkFileView のビルドマシン
Maven	3.9.x	バックエンドまたは kkFileView のビルド時に必要
Node.js	22.x	フロントエンドのビルドマシンのみ
npm	Node.js に同梱	フロントエンドの依存関係のインストールとビルド

本チュートリアルでは、qOntology API、Neo4j、kkFileView の実行と、バックエンドおよび kkFileView のソースビルドに JDK 17 を使用します。バックエンドの POM は Java 17 を指定しています。サービス起動時には Java 17 のパスを明示し、グローバルの既定値に依存しないようにします。フロントエンドは Vite 5 を使用し、本チュートリアルでは Node.js 22 に統一します。Vite 5 の環境要件

1. システムの準備

1.1. システムとリソースの確認

デプロイ先ホストで実行します。

# OS と CPU アーキテクチャを確認
cat /etc/os-release
uname -m

# 利用可能なメモリ、ディスク容量、待ち受けポートを確認
free -h
df -h / /opt /var
sudo ss -lntp

Ubuntu 22.04 であり、アーキテクチャの出力が x86_64 であることを確認します。リソース仕様に従ってディスクとメモリを確保し、8897、8097、3306、6379、7474、7687、8012 が他のインスタンスで使用されていないことを確認してください。

1.2. 基本ツールの準備

# パッケージ情報を更新し、ダウンロード・展開・証明書の基本ツールをインストール
sudo apt update
sudo apt install -y ca-certificates curl wget git tar unzip xz-utils fontconfig

# 今回のデプロイ用のダウンロードディレクトリを作成して移動
mkdir -p "$HOME/qontology-packages"
cd "$HOME/qontology-packages"

以降のダウンロードはこのディレクトリに保存します。公式アーカイブの取得後、ダウンロードページのチェックサムファイルを使用して SHA256 または SHA512 を確認してください。別のアーキテクチャ向けパッケージは使用しないでください。

2. JDK 17

2.1. インストール

# Java 17 をインストールし、絶対パスで実行・コンパイルツールのバージョンを確認
sudo apt install -y openjdk-17-jdk
/usr/lib/jvm/java-17-openjdk-amd64/bin/java -version
/usr/lib/jvm/java-17-openjdk-amd64/bin/javac -version

2.2. 現在のユーザーのビルド環境を設定

ビルドユーザーの ~/.profile に一度だけ追加します。

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"

現在の Bash セッションに反映して確認します。

source "$HOME/.profile"
java -version
javac -version

両方ともメジャーバージョン 17 を表示する必要があります。Java 17 では JDK 8 の JRE_HOME や手動の CLASSPATH 設定は不要です。systemd はユーザーの ~/.profile を読み込まないため、後続のサービスファイルで Java 実行ファイルを明示します。

3. Maven

この節はビルドマシンでのみ実行します。Apache Maven ダウンロードページで 3.9.x の binary tar.gz とチェックサムファイルを選択してください。Maven 4 や source アーカイブは選択しません。

3.1. ダウンロードと展開

ダウンロードしたファイルを ~/qontology-packages に配置し、以下のファイル名を実際の 3.9.x バージョンに置き換えます。変数は今回取得したアーカイブのみを指します。

# 実際にダウンロードした Maven アーカイブを指定し、存在を確認
cd "$HOME/qontology-packages"
MAVEN_ARCHIVE='apache-maven-3.9.x-bin.tar.gz'
test -f "$MAVEN_ARCHIVE"

# アーカイブの最上位ディレクトリを除いてインストール先に展開
sudo install -d /opt/maven
sudo tar -xzf "$MAVEN_ARCHIVE" -C /opt/maven --strip-components=1

このパスは初回インストール用です。/opt/maven が既に存在する場合はバージョンを確認し、既存ファイルに混在する形で上書きしないでください。

3.2. 設定と検証

~/.profile に一度だけ追加します。

export MAVEN_HOME=/opt/maven
export PATH="$MAVEN_HOME/bin:$PATH"

source "$HOME/.profile"
mvn -version

Maven が 3.9.x、Java が 17、Java home が Java 17 のインストール先であることを確認します。Maven 公式インストール手順も参照してください。

4. Node.js と npm

この節はフロントエンドのビルドマシンでのみ実行します。Node.js 公式ダウンロードページで 22.x、Linux、x64 の tar.xz バイナリーと対応する SHASUMS256.txt を選択します。ダウンロードページの既定表示が別のメジャーバージョンでも、そのまま使用しないでください。

4.1. 展開

アーカイブとチェックサムファイルを ~/qontology-packages に配置し、実際のファイル名に置き換えます。

# 実際の Node.js アーカイブを指定し、SHA256 を確認
cd "$HOME/qontology-packages"
NODE_ARCHIVE='node-v22.x.y-linux-x64.tar.xz'
grep " $NODE_ARCHIVE\$" SHASUMS256.txt | sha256sum -c -

# 検証後、最上位ディレクトリを除いてインストール先に展開
sudo install -d /opt/node22
sudo tar -xJf "$NODE_ARCHIVE" -C /opt/node22 --strip-components=1

チェックサムが一致しない場合や該当行がない場合は、展開を中止してファイルを再確認します。/opt/node22 も初回インストール用の空ディレクトリとして使用してください。

4.2. 環境変数と検証

~/.profile に一度だけ追加します。

export PATH="/opt/node22/bin:$PATH"

source "$HOME/.profile"
node -v
npm -v

Node.js は v22.*、npm はバージョン番号を表示すれば正常です。npm、Vue CLI、Vite の追加のグローバルインストールは不要です。プロジェクトの依存関係はアプリケーションのビルド手順でインストールします。

5. 環境チェックリスト

確認項目	期待する結果
Java 17 の絶対パスで java -version を実行	qOntology API・Neo4j・kkFileView 用のバージョン 17
ビルドマシンで mvn -version を実行	Maven 3.9.x、Java 17
フロントエンドのビルドマシンで node -v、npm -v を実行	Node.js 22.x と利用可能な npm
ディスクと待ち受けポート	十分な空き容量と、予定ポートに競合がないこと

ここまでで完了するのは基礎環境の準備であり、データベースやアプリケーションの起動ではありません。次はデータベースとミドルウェアのデプロイです。