1. 概述编辑
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V2.6.0 | - |
1.2 应用场景
在部署新项目时，由于前期准备不充足，或环境配置无法支撑部署，可能会导致部署失败。
因此，在「部署新项目」过程中，运维平台提供「环境检测」功能，对项目部署环境进行检测。
本文提供各检测项的说明与解决方案。
2. 操作系统编辑
| 说明 | |
|---|---|
| 检测内容 | 检测节点配置中各个服务器的操作系统版本是否满足部署要求，是否一致 |
| 是否必须通过 | 不强制，不通过也可部署项目 |
| 调整建议 | 1）建议同一项目使用的各个服务器，操作系统版本完全一致 2）优先推荐使用 Ubuntu 22 版本的操作系统 |
3. 服务器时区编辑
| 说明 | |
|---|---|
| 检测内容 | 检测节点配置中各个服务器的时区是否一致 |
| 是否必须通过 | 必须通过 服务器时区存在不一致，则无法部署项目 服务器时区不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 |
| 调整建议 | 请参考文档：Linux系统时区调整 对各个服务器的时区进行调整，确保完全一致 |
4. 服务器时间编辑
| 说明 | |
|---|---|
| 检测内容 | 检测节点配置中所有服务器的时间误差是否超过5秒 |
| 是否必须通过 | 必须通过 所有服务器时间误差超过5秒，则无法部署项目 服务器时间不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 |
| 调整建议 | 推荐使用网络时间协议（NTP），确保多个服务器时间的准确性和自动同步。 请根据你的服务器操作系统版本，自行查阅资料配置。 |
5. 目录合法性编辑
| 说明 | |
|---|---|
| 检测内容 | 对于自己准备的组件 1）确认文件服务组件的文件挂载路径是共享目录 2）确认其他组件的工程路径不是共享目录 |
| 是否必须通过 | 必须通过 如路径不合法，则无法部署项目 |
| 调整建议 | 1）优先建议使用运维平台部署全部组件 2）自行对报错中指出的目录进行检查和调整 |
6. 镜像版本检测编辑
| 说明 | |
|---|---|
| 检测内容 | 1）检测运维平台对接的镜像仓库，是否存在所需组件镜像 2）如不存在，检测是否支持连接帆软云端仓库，从云端拉取相关组件镜像 |
| 是否必须通过 | 必须通过 如从本地镜像仓库/云端镜像仓库均无法获取组件镜像，则无法部署项目 |
| 调整建议 | 1）对于内网用户 请参考文档：手动推送镜像入库 2）对于外网用户 请参考文档：确认镜像仓库支持连接帆软云端仓库 |
7. 端口占用及连通性编辑
| 说明 | |
|---|---|
| 检测内容 | 1）检查项目各个服务器中，各个组件所需占用的端口是否空闲 2）检查需要连通的各个组件，网络是否可访问 包括镜像仓库与项目、运维平台与项目组件、项目组件之间 |
| 是否必须通过 | 必须通过 1）端口不空闲，无法成功部署组件 2）网络不互通，项目组件无法成功连通或被运维平台管理 |
| 调整建议 | 请参考文档：端口占用检查与防火墙配置 对端口占用情况进行处理，对防火墙进行放开 |
8. 权限检测编辑
| 说明 | |
|---|---|
| 检测内容 | 检查节点配置中填写的服务器用户，是否有足够权限完成项目部署和运行 |
| 是否必须通过 | 必须通过 检测到任意一个节点的任意一个命令无权执行，均无法进行项目部署 |
| 调整建议 | 1）优先推荐使用root超管用户进行项目部署和运行 2）如需使用非超管root用户进行项目的部署和运行 请参考文档：用户权限说明 |
9. 残留检测编辑
| 说明 | |
|---|---|
| 检测内容 | 检测节点配置中的各个服务器中，是否已存在docker、运维平台、帆软应用 |
| 是否必须通过 | 不强制，不通过也可部署项目 |
| 调整建议 | 建议在全新服务器部署项目 即所准备的服务器中，未部署任何docker、运维平台、帆软应用 |