Java プロジェクトのデプロイ

Zeabur は、Maven または Gradle ビルドシステムを使用し、ネイティブまたは Spring Boot フレームワークの Java プロジェクトのデプロイをサポートしています。

JAR ファイルの検出

デフォルトでは、Zeabur は標準のビルド出力ディレクトリから JAR(または WAR)ファイルを自動的に検出します:

  • Maventarget/*.jar(または target/*.war
  • Gradlebuild/libs/*.jar(または build/libs/*.war

標準的なシングルモジュールプロジェクトでは、追加の設定は不要です。

JAR ファイルがサブディレクトリにある場合

JAR ファイルがデフォルトの場所にない場合——例えば、マルチモジュールプロジェクトで実行可能な JAR がサブモジュール内にビルドされる場合——zbpack.jsonjavaArgs でパスを明示的に指定する必要があります:

{
  "javaArgs": "-jar my-server/target/server.jar"
}

Spring Boot プロジェクトの場合、Zeabur がサービスにトラフィックをルーティングできるよう、ポートバインディングも含めてください:

{
  "javaArgs": "-Dserver.port=$PORT -jar my-server/target/server.jar"
}
💡

javaArgs を設定すると、デフォルトの起動コマンドが完全に置き換えられます-jar path/to/your.jar を自分で含める必要があります。

プロジェクトがサブディレクトリにある場合

Java プロジェクト全体(pom.xmlbuild.gradle を含む)が Git リポジトリのサブディレクトリにある場合は、代わりにルートディレクトリ設定を使用してください。これにより、Zeabur はそのサブディレクトリをプロジェクトルートとして扱い、デフォルトの JAR 検出が正常に機能します。

環境設定

使用可能な JDK のバージョンは以下の通りです:

  • 19
  • 17(デフォルト)
  • 11
  • 8
  • 7

JDK バージョンの指定

pom.xml または build.gradle で JDK バージョンを指定できます。

例えば、Maven を使用している場合、pom.xml に以下を追加します:

<properties>
    <java.version>11</java.version>
</properties>

Gradle を使用している場合は、build.gradle に以下を追加します:

sourceCompatibility = 11

JVM スタートアップパラメータの指定

zbpack.jsonjavaArgs フィールドで Zeabur のデフォルトの JVM スタートアップパラメータを上書きできます。 javaArgs を使用する場合、-jar と JAR ファイルのパスを含む完全なコマンド引数を指定する必要があります。

{
  "javaArgs": "-Xms128m -Xmx512m -jar target/your-app.jar"
}