Skip to main content
Version: v5.1

Rainbond源码构建JAVA项目选取JDK

默认提供的JDK​

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

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

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

  • WEB界面指定：
  • system.properties指定方式：
# system.properties 目前Rainbond能识别的版本值为11,10,1.9,1.8,1.7,1.6
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
  • 创建自定义的本地制品仓库，并上传自定义的jdk包。

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

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

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

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

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

替换默认JDK​

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

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

接下来是详细的步骤：

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

Dockerfile内容：

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

构建操作：

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

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

#vi /opt/rainbond/conf/base.yaml
#在末尾追加
- name: rbd-java-buildpack
  endpoints:
  - name: BUILDPACK_ENDPOINTS
    protocol:
    port: 2017
  health:
    name: rbd-java-buildpack
    model: http
    address: 127.0.0.1:2017/lang/
    max_errors_num: 3
    time_interval: 30
  after:
    - docker
  type: simple
  pre_start: docker rm rbd-java-buildpack
  start: >-
    docker run --name rbd-java-buildpack
    --network host
    -i goodrain.me/buildpack:java-v5.1.5
  stop: docker stop rbd-java-buildpack
  restart_policy: always

启动服务：

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

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

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

总结​

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

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