FrameworksJava
💡

Este artículo aún no está completo. Si tienes alguna pregunta, no dudes en preguntar en la Discusión.

Además, si te gustaría contribuir a este artículo, siéntete libre de abrir un Pull Request en nuestro Repositorio de GitHub.

Deploying Java Projects

Zeabur supports deploying Java projects that use the Maven or Gradle build systems, with either native or Spring Boot frameworks.

Descubrimiento de archivos JAR

Por defecto, Zeabur encuentra automáticamente tu archivo JAR (o WAR) en el directorio de salida de compilación estándar:

  • Maven: target/*.jar (o target/*.war)
  • Gradle: build/libs/*.jar (o build/libs/*.war)

Esto funciona sin configuración adicional para proyectos estándar de un solo módulo.

JAR en un subdirectorio

Si tu archivo JAR no está en la ubicación predeterminada — por ejemplo, en un proyecto multi-módulo donde el JAR ejecutable se genera en un submódulo — necesitas especificar la ruta explícitamente usando javaArgs en zbpack.json:

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

Para proyectos Spring Boot, recuerda incluir el enlace de puerto para que Zeabur pueda enrutar el tráfico a tu servicio:

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

Cuando se configura javaArgs, reemplaza completamente el comando de inicio predeterminado. Debes incluir -jar path/to/your.jar tú mismo.

Proyecto en un subdirectorio

Si todo tu proyecto Java (incluyendo pom.xml o build.gradle) está en un subdirectorio del repositorio Git, usa la configuración de Directorio raíz en su lugar. Esto le indica a Zeabur que trate ese subdirectorio como la raíz del proyecto, y el descubrimiento predeterminado de JAR funcionará normalmente.

Environment Setup

The available JDK versions are:

  • 19
  • 17 (default)
  • 11
  • 8
  • 7

Specifying JDK Version

You can specify the JDK version in pom.xml or build.gradle.

For example, if you’re using Maven, add the following to pom.xml:

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

If you’re using Gradle, add the following to build.gradle:

sourceCompatibility = 11

Especificar parámetros de inicio de JVM

Puedes sobreescribir los parámetros de inicio de JVM predeterminados de Zeabur con el campo javaArgs en zbpack.json. Al usar javaArgs, debes incluir los argumentos completos del comando, incluyendo -jar y la ruta a tu archivo JAR.

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