错误信息表明,在使用CKMan部署ClickHouse时,服务器在验证阶段发现了"无效的IP范围"。
📋 错误分析
错误发生在/api/v1/deploy/ck这个API接口,核心原因为:invaild ip range 。
具体来说,CKMan在部署配置中收到了一个无法识别或格式错误的IP地址、子网或者IP范围列表,导致部署过程无法继续。
🔍 排查与解决建议
你需要重点检查提交给CKMan的部署配置文件中的网络相关设置。
-
检查节点IP配置:
-
在你用于部署的JSON或YAML配置文件中,仔细核对
hosts、ssh_host、zookeeper_nodes等字段下填写的所有IP地址。 -
确保它们都是有效且格式正确 的IPv4地址(例如
192.168.1.10),并且与目标服务器的实际网络地址一致。
-
-
检查IP范围格式:
- 如果配置中指定了IP地址范围(CIDR格式,如
192.168.1.0/24),请确保该CIDR格式书写正确,并且符合你网络的规划。
- 如果配置中指定了IP地址范围(CIDR格式,如
-
验证网络连通性:
-
在CKMan服务器上,尝试使用
ping或ssh命令连接配置中填写的目标IP地址,确认网络是可达的。 -
如果使用的是主机名而非IP,请确认它能被正确解析。
-
-
查看详细日志:
- 错误堆栈显示CKMan会将详细日志写入文件(
ginLoggerToFile.func5)。检查CKMan的应用程序日志,通常可以在日志中找到关于具体是哪个IP或哪项配置无效的更详细描述。
- 错误堆栈显示CKMan会将详细日志写入文件(
解决方案:
由于配置的zookeeper为阿里云的zookeeper,线上地址为类似
mse-xxxxxxx-zk.mse.aliyuncs.com这种格式,导致ckman判断为不合法的IP地址报错。
解决办法为自建带IP的zookeeper