应用构建排查

镜像构建问题排查

由镜像构建,是Rainbond构建应用的一种基本方式,具体操作参见 DOCKER镜像支持规范

在构建的过程中,可能出现如下问题。

服务构建源检测未通过

出现此报错截图,说明Rainbond未能拉取到指定的镜像。

  • 解决方案:
    • 首要检查,在Rainbond管理节点尝试 docker pull <指定镜像> 是否可以正常拉取到镜像
    • 检查镜像地址是否有写错。包括但不限于中文态的 “:” 等
    • 检查镜像仓库是否需要用户名密码。如需要,确定是否在构建时填写用户名密码
    • Rainbond服务器到镜像仓库服务器是否有网络限制。检查网络通信,端口是否开放

基于镜像构建应用,是一种非常稳健的构建方式。只要能够正常获取镜像,那么构建肯定可以成功。在运行时出现 运行异常 请参考应用运行排查

基于Dockerfile源码构建问题排查

基于Dockerfile源码构建时,具体操作参见 DOCKERFILE构建规范

在构建过程中,可能出现如下问题。

服务构建源检测未通过

出现此报错字样,说明Rainbond未能从代码仓库中正确获取代码。

  • 解决方案:
    • 确认项目地址填写是否无误,如需拉取的代码在项目根目录下的某个子目录下,则在仓库地址后接?dir=<子目录名>
    • 项目需要安全验证,没有提供正确的用户名密码。
    • 使用了ssh协议拉取代码,需要确认ssh授权是否正确。
    • Rainbond服务器到代码仓库是否有网络限制,域名是否可以解析。简单的验证策略是在Rainbond管理节点测试 git clone <仓库地址>

构建失败

代码正常获取后,Rainbond将自动进入构建过程。具体日志将在 操作日志 中体现。如果构建操作最终体现 构建失败

  • 解决方案:
    • 操作日志中会有构建流程的详细记录,参阅是否有报错。
    • 在Rainbond管理节点尝试构建此项目,如构建失败,则优先检查Dockerfile代码。搜索诸如 九个编写Dockerfile的常见错误 之类的文档来学习编写 Dockerfile。
    • 确定Rainbond服务器是否可以连通指定资源来执行诸如 apt-get wget 等操作。

构建超时

构建过程中如果出现 构建超时,这未必一定指征构建已经失败了!只是说明构建耗时超过了Rainbond设定的默认值。是否失败,以及确定构建错误原因,请参见 操作日志 具体信息。

基于JAVA语言源码构建问题排查

基于JAVA语言源码构建时,具体操作参见 JAVA开发语言支持规范

Java语言是市面上使用最多的开发语言。Rainbond除了直接部署jar、war包项目,还支持java-maven项目直接构建。在构建过程中,可能出现如下问题。

服务构建源检测未通过

出现此报错字样,说明Rainbond未能从代码仓库中正确获取代码。

  • 解决方案:
    • 确认项目地址填写是否无误,如需拉取的代码在项目根目录下的某个子目录下,则在仓库地址后接?dir=<子目录名>
    • 项目需要安全验证,没有提供正确的用户名密码。
    • 使用了ssh协议拉取代码,需要确认ssh授权是否正确。
    • Rainbond服务器到代码仓库是否有网络限制,域名是否可以解析。简单的验证策略是在Rainbond管理节点测试 git clone <仓库地址>

GZIP STDIN NOT IN GZIP FORMAT

出现此报错字样,确认为下载jdk或者maven失败。

构建失败

在进入maven构建阶段后,操作日志将打印以 [INFO] [WARNING] [ERROR] 等字样开头的maven构建信息。在这个阶段报错,原因非常复杂多变。我们准备了专门的文档来描述这个过程的原理,相关设置以及具体排查文档。请依次详读以下文档:

我的问题没有被涵盖

如果你在阅读了这篇文档后,依然构建失败,你可以:

  • 移步 GitHub 查询是否有相关的 issue ,如没有则提交 issues

  • 前往社区 阅读前缀名为【构建问题】【使用问题】的帖子,寻找相似问题的答案