導入・起動

ソースをビルドして配布ディレクトリを作り、最小のページで起動を確認します。

必要な環境

JDK 21（JREだけではJSPのコンパイルができません）、Maven 3.9以上、起動スクリプトを実行できるBashを用意します。リポジトリのビルドラッパーは /opt/java/jdk21 を固定参照します。実行用JDKは KOHAKU_JAVA_HOME で指定できます。

/opt/java/jdk21/bin/java -version
/opt/java/jdk21/bin/javac -version
mvn -version

1. 配布物をビルドする

   リポジトリのルートで実行します。全モジュールのテストと品質ゲートも実行します。

   ビルドコピー

   bin/mvn21 -q clean verify

   配布ディレクトリは dist/kohaku-dist/target/kohaku/ です。これはソースの bin/mvn21 と別の bin/kohaku.sh を持ちます。

2. ローカルで試す設定にする

   生成された配布ディレクトリへ移動し、conf/server.yaml を編集します。

   作業ディレクトリの変更コピー

   cd dist/kohaku-dist/target/kohaku

   conf/server.yaml — ローカル確認用コピー

   http:
     host: "127.0.0.1"
     port: 8080
   management:
     host: "127.0.0.1"
     port: 9090

   管理ポートはこの例で明示的に有効化しています。既定では開きません。

3. 確認用ページを置く

   配布ディレクトリで実行コピー

   mkdir -p webapps/hello
   printf '%s\n' '<!doctype html><html lang="ja"><meta charset="UTF-8"><title>Hello</title><h1>Kohaku is running</h1></html>' > webapps/hello/index.html

4. フォアグラウンドで起動する

   配布ディレクトリで実行コピー

   bin/kohaku.sh run

   JDKが別の場所にある場合は次の形にします。/path/to/jdk21 は実在するJDKへ置き換えてください。

   実行用JDKを指定コピー

   KOHAKU_JAVA_HOME=/path/to/jdk21 bin/kohaku.sh run

5. 別のターミナルから確認する

   HTTPとreadinessの確認コピー

   curl -i http://127.0.0.1:8080/hello/index.html
   curl -i http://127.0.0.1:9090/health/ready

   ページは200と作成した本文、readinessは200と UP を返します。アプリ未配備のルート / に404が返る構成は正常です。停止は起動ターミナルでCtrl-Cを押します。

配布ディレクトリ

バックグラウンド実行

bin/kohaku.sh start
curl -i http://127.0.0.1:9090/health/ready
bin/kohaku.sh stop