作为系统管理员,我们假定您具备了一定的专业背景知识,否则以下安装过程可能无法顺利进行。如果您不具备相关的专业知识,可以考虑 购买 我们的商业服务。
RB 使用 Java 开发,因此可运行在几乎所有操作系统上,如 Windows/Linux/macOS 等。 同时 RB 还依赖以下软件环境,建议在安装前准备好。如果您使用 Windows 平台并只是用于测试评估,那么它们都不是必须的(请参照下文)。
? MySQL 5.7 及以上请移除
SQL_MODE
中的ONLY_FULL_GROUP_BY
项。详见 https://www.cnblogs.com/easilyai/p/11729882.html
? MySQL 8.0 及以上需要启用
mysql_native_password
即密码认证模式。详见 https://blog.csdn.net/beyond_yanbo/article/details/82458494
! 请勿与其他系统共用 Redis,因为在某些情况下 RB 可能会刷新/清空缓存
对于硬件方面的需求,主要取决于系统的并发量和数据量。按照一般情况,我们建议的硬件如下:
您可以到 RB 官网 下载最新版安装包,也可以至 RB 的 GitHub 项目 页下载。每个发型版本我们都会提供一键安装包,安装包分为两种:
rebuild-standalone-x.y.z.zip
为外置 Tomcat 运行模式,其中包含了 Tomcat-8.5 和 OpenJDK-11(此 JDK 仅针对 64 位 Windows 系统,其他操作系统请自备 JDK/JRE)rebuild-boot-x.y.z.jar
为 SpringBoot jar
独立运行模式(2.0 版本开始提供)请下载需要的版本安装包备用。
您也可以将
rebuild-standalone-x.y.z.zip
文件解压后,复制目录下的REBUILD
至其他 Tomcat 中使用
解压安装包并进入主目录,双击 start-rebuild.bat
即可启动。
?
bat
文件仅适用于 Windows 平台,如果您使用 Linux/macOS 请至bin
目录下运行startup.sh
脚本启动,启动前请确认已正确配置 JDK/JRE 环境,否则启动会失败。
jar
启动可以通过以下命令直接启动。
java -jar rebuild-boot-x.y.z.jar
通常情况下您还需要指定一些额外的启动参数,并以后台模式运行,因此以下(Shell)命令可能更为适合。
// https://github.com/getrebuild/rebuild/tree/master/.deploy/restart-rebuild.sh
nohup java -Xms2G -Xmx2G -XX:+UseG1GC -Djava.awt.headless=true -jar rebuild-boot-x.y.z.jar >/dev/null 2>&1 &
启动后请打开浏览器,并输入 http://127.0.0.1:18080/ 访问,RB 会自动引导您进入安装过程。
RB 使用 SpringBoot 开发,若有兴趣可以参考 官方文档 查询更多启动方式
进入安装页后,有两种安装模式可供选择。其中 [快速安装] 将使用内置的 H2 数据库进行安装,此模式非常简单,可以快速安装体验 RB 功能,但请注意,此模式仅供测试使用,且部分功能可能无法使用。
使用 [快速安装] 模式步骤较为简单,因此本文主要介绍 [标准安装] 。
点击 [标准安装] 首先进入数据库设置。在数据库设置字段中都有合理的默认值,您可以使用默认值,也可以自行填写。设置完毕后点击下一步,系统会自动测试连接,如测试失败将提示失败原因,请根据错误做相应调整。
?请赋予 MySQL 用户足够的权限,否则数据库可能会初始化失败
缓存有助于提高系统访问速度,RB 支持以下两种缓存:
其中 Redis 具有更好的访问性能,与之相对的是更为复杂的配置。非高并发情况下使用内置的 Ehcache 即可满足。
在管理员设置页面,您可以为管理员指定新的密码和管理员邮箱,默认密码为 admin
。需要注意的是,管理员的登录名不能修改,固定为 admin
。
您可以选择由 RB 仓库 提供的已经配置好的实体直接使用。此步骤不是必须的,您也可以在安装完成后至管理员后台 - 实体管理 - [添加实体] 进行安装,所提供的实体与此步骤是一致的。
选择完毕后点击 [完成安装] 即可进入安装过程。
按照设置好的参数,RB 将进入自动安装过程,此过程一般需要 30-60 秒左右,完成后即可登录使用。如果安装失败,系统会提示错误原因,请根据错误提示进行相应调整后重新安装。
安装过程如遇问题,请向我们 提交 或购买我们的 商业服务 支持。
以上安装过程适用于 V2.0 及更高版本,之前的版本请 参考此处
在生产环境中,系统可用性是关键的系统质量指标,RB 会定期检测系统健康并实时反应在服务状态页面。
同时,RB 还提供了一个供第三方监控系统使用的接口 http://YOUR-RB-SERVER/error/server-status.json
。您可以使用任意监控系统对此地址进行监控,并对返回结果进行验证即可。
进入腾讯云控制台 - 云拔测 - 站点质量监控,点击 [新建任务] 添加一个新的监测,并参考如下配置。