Rainbond源码构建JAVA项目选取JDK

默认提供的JDK

Rainbond官方提供了多个版本的OpenJDK供用户使用。这些OpenJDK的安装包托管于好雨科技官方的OSS(对象存储)中。能够接入互联网的Rainbond平台,可以通过rbd-repo组件的代理获取这些资源,而不用人工干预。

用户通过WEB界面配置,或在源码根目录创建system.properties,设定java.runtime.version来指定OpenJDK版本。

WEB界面设置的值优先级高于system.properties中设定的值。

  • WEB界面指定:

RAINBOND源码构建JAVA项目选取JDK - 图1

  • system.properties指定方式:
  1. # system.properties 目前Rainbond能识别的版本值为11,10,1.9,1.8,1.7,1.6
  2. java.runtime.version=1.8

在不做出其他任何调整的情况下,在Rainbond执行源码构建时,会获取以下版本的OpenJDK资源:

OpenJDK版本资源地址
1.8(默认)http://lang.goodrain.me/jdk/cedar-14/openjdk1.8.0_201.tar.gz
1.6http://lang.goodrain.me/jdk/openjdk1.6.0_27.tar.gz
1.7http://lang.goodrain.me/jdk/cedar-14/openjdk1.7.0_201.tar.gz
1.9http://lang.goodrain.me/jdk/cedar-14/openjdk9.0.4.tar.gz
10http://lang.goodrain.me/jdk/cedar-14/openjdk10.0.2.tar.gz
11http://lang.goodrain.me/jdk/cedar-14/openjdk11.0.2.tar.gz

特别提醒:如果maven编译过程中发生错误,请自行下载对应的JDK到自己的环境中,尝试本地构建,来确认是否由于OpenJDK版本问题导致了编译失败。

自定义JDK

多数用户希望能够自定义JDK,比如希望使用特定版本的OpenJDK,或者具备Oracle的授权使用OracleJDK。接下来就会讲解如何自定义。

Rainbond平台集成了 Jforg出品的 Artifactory 作为制品库(即rbd-repo组件)。在这里我们可以上传并存储自己的资源,包括jdk包。

  • 首先,访问 http://<管理节点IP>:8081 登录 Artifactory,默认凭证: admin/password

RAINBOND源码构建JAVA项目选取JDK - 图2

  • 创建自定义的本地制品仓库,并上传自定义的jdk包。

RAINBOND源码构建JAVA项目选取JDK - 图3

需要注意的是,Artifactory 上传文件的默认限制是不能超过 100MB。如果上传的文件超过了这个限制,可以在 Admin > General Configuration 页面中设置 File Upload Max Size 项为一个合适的值。

  • 在平台WEB界面指定自定义JDK地址,设置处为应用构建源。

像上述方式上传的jdk包,其地址为: http://<管理节点IP>:8081/artifactory/<自定义仓库名>/<文件名&gt;

类似: http://192.168.1.1:8081/artifactory/jdk2/jdk-8u201-linux-x64.tar.gz

RAINBOND源码构建JAVA项目选取JDK - 图4

至此,自定义JDK就完成了。

替换默认JDK

自定义JDK自由度更高,能适应更多的使用场景。但是其短板在于JDK获取地址在每一个新建的应用中都要设置一遍。有没有方式,可以替换Rainbond默认提供的JDK包呢?如果可以实现这个功能,那么每次构建都不用做其他设置,使用默认路径,即可安装公司内部指定版本的JDK,岂不是很方便?

默认JDK的地址,实际上指向了Rainbond官方的对象存储,这对于Artifactory而言,属于一种远程仓库(remote repository)。在Artifactory中,是没有办法通过上传文件,来替换远程仓库中的文件的。所以,我们要在本地建立另一个仓库,来替换Rainbond官方提供的远程仓库。

接下来是详细的步骤:

  • 用Rainbond官方提供的 rbd-java-buildpack 镜像作为基础,结合自需JDK包制作镜像(以默认的1.8版本为例)
  1. #构建目录的文件结构如下:
  2. .
  3. ├── Dockerfile
  4. └── jdk-8u201-linux-x64.tar.gz #这里使用OracleJDK1.8 为例替换,用户根据自己需求自行更改

Dockerfile内容:

  1. FROM rainbond/buildpack:java-v5.1.5
  2. COPY jdk-8u201-linux-x64.tar.gz /pkg/lang/jdk/cedar-14/openjdk1.8.0_201.tar.gz

构建操作:

  1. docker build -t goodrain.me/buildpack:java-v5.1.5 .
  • 启动服务

在管理节点编辑指定配置文件:

  1. #vi /opt/rainbond/conf/base.yaml
  2. #在末尾追加
  3. - name: rbd-java-buildpack
  4. endpoints:
  5. - name: BUILDPACK_ENDPOINTS
  6. protocol:
  7. port: 2017
  8. health:
  9. name: rbd-java-buildpack
  10. model: http
  11. address: 127.0.0.1:2017/lang/
  12. max_errors_num: 3
  13. time_interval: 30
  14. after:
  15. - docker
  16. type: simple
  17. pre_start: docker rm rbd-java-buildpack
  18. start: >-
  19. docker run --name rbd-java-buildpack
  20. --network host
  21. -i goodrain.me/buildpack:java-v5.1.5
  22. stop: docker stop rbd-java-buildpack
  23. restart_policy: always

启动服务:

  1. node service update
  • 修改Artifactory中的远程仓库pkg_lang 的远程地址为 http://<管理节点IP>:2017/lang

RAINBOND源码构建JAVA项目选取JDK - 图5

如果已经用Rainbond官方远程仓库获取过JDK包,那么要在 pkg_lang-cache中清除已缓存的记录。

至此,就已经将默认的OpenJDK1.8版本,替换成为指定的 OracleJDK1.8版本了。

总结

基于这篇文章,用户已经可以灵活掌握配置使用各种JDK的方式了。

在这篇文章之后,我们会继续发布如何灵活配置Maven环境的文章,敬请期待。