问题诊断 - 组件构建排查 - 《Rainbond v5.2 文档手册》

组件构建排查

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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