Java Maven源码部署组件

    Maven 项目识别策略

    当源代码根目录下存在 pom.xml 文件，且不存在 Dockerfile 文件时，Rainbond 会将源代码识别为 Java Maven 项目。

    Maven 多模块项目构建，请直接参考 Java Maven 多模块源码构建。

    验证准备

    将项目部署到 Rainbond 之前，请按照以下步骤进行本地验证，本地构建成功后，即可开始尝试将项目部署在 Rainbond 上。

    • 源代码托管于 Git 或 SVN 服务器。

    • 检查本地构建环境与运行环境，确定 Maven 版本、JDK 版本、是否使用了 OracleJDK。

    • 清除本地构建缓存，一般情况下，本地 localRepository 位于 ，请在确认后，将该文件夹临时更改路径。
    1. mv ${HOME}/.m2/repository ${HOME}/.m2/repository.bak
    • 执行以下构建命令，该命令也是 Rainbond Java Maven 项目构建的默认命令：
    • 非 SpringBoot 项目打包方式推荐使用 war 包方式。

    编译运行环境配置

    环境准备阶段，需要将 Rainbond 构建运行环境，和常用的本地构建运行环境尽量统一。比如 JDK 版本、Maven 版本等。

    图形化设置

    Rainbond 支持图形化定义编译运行环境，配置位于服务组件的构建源页面。对这些配置的修改，需要通过 来生效！

    • 禁用缓存，在完成首次成功的构建之前，该开关应该始终处于打开的状态，默认关闭。

    • 选择编译运行所使用的 JDK（默认提供 OpenJDK） 以及 MAVEN 版本，务必使用验证准备时验证过的版本。

    • 选择自定义 JDK 下载地址，需要提供 Rainbond 服务器可以下载到的路径，来下载 tar.gz 格式的 JDK（可以是 OracleJDK） 安装包。

    • 当构建产物为 war 文件时，还提供了 Tomcat、Jetty 的版本选择。

    • 禁用 Maven Mirror，该开关决定是否通过 rbd-repo 进行代理（默认代理至阿里云 maven 仓库），一旦开关打开，下方定义的 MAVEN MIRROR OF 配置与 MAVEN MIRROR URL 配置全部失效，构建过程中使用的仓库地址将只取决于 pom.xml 文件中的定义（如文件中无 repositories 定义，则从 Maven 中央仓库拉取依赖）。

    • MAVEN MIRROR OF 配置，与 MAVEN MIRROR URL 配置一起使用，可以定义构建过程中从镜像私服中拉取依赖的行为。默认配置为 central，如设置为 *，则所有的依赖包都会从 MAVEN MIRROR URL 配置中定义的镜像仓库地址拉取。

    • MAVEN MIRROR URL 配置，定义了构建过程中使用的仓库私服地址，Rainbond 不支持 jar 包本地安装部署，所有需要的第三方 jar 包，请上传到仓库私服中去。默认的 maven.goodrain.me 为 rbd-repo 组件的内网解析域名，它代理了阿里云 maven 仓库。

    • MAVEN 构建参数、构建命令两个选项，组成编译所执行的命令，默认构建命令为 mvn -DskipTests clean dependency:list install 。

    • MAVEN 构建 java 参数配置，主要用来指定构建过程中分配的堆栈内存，该配置只影响 maven 构建过程，构建完成的组件运行时指定的堆栈内存由 ${JAVA_OPTS} 变量指定。

    通过代码设置(推荐)

    Rainbond 支持将上述的所有配置通过代码进行定义。这样做的好处是：通过在源代码仓库加入若干配置文件，完成编译运行环境的定义，不需要任何手动配置，完成自动 CI。

    system.properties

    在源代码根目录下加入 system.properties 文件，可以定义 Maven 版本、JDK 版本，务必使用验证准备时验证过的版本：

    1. java.runtime.version=1.8
    2. maven.version=3.3.1

    二者版本选择范围如下：

    settings.xml(推荐)

    在源代码根目录下加入用户本地构建可用的 文件，即可完全模拟用户的本地构建设置，包括 仓库私服设置。该文件通常位于用户环境的 ${M2_HOME}/conf 或者 ${HOME}/.m2 目录下，用户本地构建使用的配置，均可在其中进行定义。

    在即将到来的 Rainbond v5.2.2 版本中， settings.xml 的设置，会添加到图形化设置中去。

    mvnw

    如果你的代源码根目录定义了 mvnw，将使用此脚本启动 Maven 进程。如果指定了 Maven 版本，则会忽略mvnw。使用默认命令构建。

    rainbondfile

    在源代码根目录下加入 rainbondfile 可以为服务组件定义环境变量，构建过程中更多的配置，可以通过环境变量的方式定义。

    在 Rainbond 源码构建的过程中，为服务组件定义的 开头的变量，可以被传入构建环境中使用。部分常用的环境变量如下:

    启动命令配置

    Java Maven 源码构建过程完成后，Rainbond 会自动将服务组件运行起来，这需要我们事先指定服务组件的启动命令。

    Procfile 规范

    Rainbond 通过源代码根目录下的 Procfile 文件来定义项目启动命令，Procfile 文件定义规范详见 。

    服务组件构建源页面中可以图形化输入启动命令，这里输入的命令格式要求与 Procfile 一致，优先级高于源代码根目录中的 Procfile 。输入完成后，下一次构建当前服务组件时生效。

    如果项目未定义 Procfile 文件,平台默认会根据识别项目类型生成默认 Procfile。

    • 打包方式为 war 包,平台使用 webapp-runner.jar 将打包好的 war 包运行起来。示例
    • 打包方式为 jar 包,示例
    1. web: java -Dserver.port=$PORT $JAVA_OPTS -jar target/*.jar

    上述是默认 Procfile ,如果需要扩展更多启动参数,可以自定义 Procfile 。

    • 和java之间有一个空格
    • 文件结尾不能包含特殊字符
    • 如果是多模块项目,需注意编译后 jar 包或者 war 包路径，其路径为<子模块名>/targets/*.jar或<子模块名>/targets/*.war
    • $PORT: 根据用户在平台设置的端口决定监听，默认监听端口为 5000
    • 选择 tomcat 不同版本时 web: java $JAVA_OPTS -jar ./webapp-runner.jar --port $PORT ./*.war
    • 选择 jetty 不同版本时 web: java $JAVA_OPTS -jar ./jetty-runner.jar --port $PORT ./*.war
    • 需要配置 context path,可以通过自定义 Procfile 指定
      • 示例 web: java $JAVA_OPTS -jar ./webapp-runner.jar --path <path路径,示例: /r6d> --port $PORT ./*.war

    Web 服务支持

    如果 Maven 项目打包成 war 包,则需要配置 Web 服务支持。

    通过 web 服务(tomcat 或者 jetty)将 war 包运行起来,即通过 java -jar ./webapp-runner.jar ./*.war 或者 java -jar ./jetty-runner.jar ./*.war 方式运行.

    目前可以通过构建源设置 web 服务版本或者源码根目录定义 webserver 文件

    1. 控制台构建源配置支持版本 tomcat7,tomcat8,tomcat85,tomcat9,jetty7,jetty9
    2. 源码根目录下定义 webserver 版本
      • webapp-runner-7.0.91.0.jar
      • webapp-runner-8.0.52.0.jar,webapp-runner-8.5.38.0.jar
      • webapp-runner-9.0.16.0.jar
      • jetty-runner-7.5.4.v20111024.jar,jetty-runner-9.4.0.v20161208.jar

    具体对应关系如下:

    选择 tomcat7 版本需要注意确定本地可以通过 java -jar ./webapp-runner-7.0.91.0.jar ./*.war 运行 。 关于 webapp-runner 详细配置请参考

    如果编译成 war 包，运行时默认会将 war 文件解压至 /app/target/ 目录下,不支持通过添加配置文件的方式到 war 解压路径下,否则会导致应用无法正常启动

    示例 demo 程序

    示例 Spring Boot 项目: https://github.com/goodrain/java-maven-demo

    常见问题解决

    • 项目比较复杂，使用上述方式无法进行编译

    • 编译失败怎么处理

    • 项目依赖包变化了但编译后发现没有生效

    • 项目编译成功，但启动后运行异常