Rancher 2.6.2单点部署后注册现有K8s集群点击创建按钮无响应

1. 前端侧问题排查 #

点击创建无响应且后端无异常日志，大概率为前端渲染或接口请求异常，优先按以下步骤核查：

• 按下F12打开浏览器开发者工具，切换到「控制台」标签，查看是否存在JavaScript报错，重点关注403/404接口错误、CORS跨域错误、静态资源加载失败三类问题
• 切换到「网络」标签，重新点击「创建」按钮，查看对应集群创建接口的请求参数和返回值，记录异常状态码和返回信息
• 尝试清除浏览器缓存、使用无痕模式打开Rancher UI重试，Rancher 2.6.2存在已知的前端缓存导致的UI渲染Bug

2. Rancher 核心配置校验 #

• 检查server-url配置是否正确，在部署Rancher的单节点K8s上执行命令：

kubectl get settings.management.cattle.io server-url -o jsonpath='{.value}'

该地址必须与你访问Rancher UI的实际地址完全一致，且待注册集群的所有节点都可以正常连通该地址

• 若你为Rancher配置了HTTP/HTTPS代理，需确认待注册集群的网段、Rancher自身服务网段、容器网段都已加入no-proxy排除列表

3. 版本兼容性校验 #

Rancher 2.6.2有严格的K8s版本兼容限制：

• 待注册的现有K8s集群版本最高支持1.22.x，若集群版本高于1.22，会触发导入流程UI渲染异常的已知问题
• 确认当前登录Rancher的账号拥有全局级别的集群创建、集群导入权限，权限不足也会导致点击创建后无返回

4. 隐藏日志排查 #

若以上步骤都未发现问题，可针对性抓取以下日志核查：

• 实时抓取Rancher主Pod日志过滤集群导入相关信息：

kubectl logs -n cattle-system $(kubectl get pods -n cattle-system -l app=rancher -o name) -f | grep -E "cluster|import"

• 检查Rancher的audit-log日志，确认点击创建的操作是否触发了权限拦截或参数校验异常

内容的提问来源于stack exchange，提问作者Viet Nguyen