为什么集群无法连接或连接凭据失效
使用 kubectl 连接失败时,应分别检查集群状态、kubeconfig 指向、认证凭据及本地到 API Server 的网络条件。集群可见不代表已经具备连接条件。
排查步骤
- 在集群管理中确认目标集群的状态。创建中或删除中的集群仅供查看;异常集群按页面可用入口排查。
- 返回目标集群的连接入口,获取当前连接信息。不要混用其他企业或其他集群的 kubeconfig。
- 使用实际文件路径显式指定 kubeconfig,确认本地客户端连接的是目标集群。
- 如提示凭据失效或认证失败,重新获取连接信息后再连接;短期凭据的有效时间以页面提示为准。
- 如仍无法连接,按下表中的错误现象继续检查。
以下命令中的路径应替换为实际 kubeconfig 路径:
kubectl --kubeconfig /path/to/kubeconfig cluster-info常见现象
| 现象 | 检查方向 |
|---|---|
| 认证失败或凭据失效 | 重新获取目标集群的连接信息,检查文件是否完整保存,避免自行替换其中的认证字段。 |
| 请求超时或地址无法解析 | 核对 kubeconfig 中的平台 API Server 网址,以及本地网络对该地址的访问条件。 |
| 提示权限不足 | 核对当前使用的企业、集群、连接信息及被拒绝的具体操作。 |
| 修改 Service 转发后仍不能连接集群 | Service 公网转发用于业务访问,不能代替或修复 API Server 的连接。 |
| 尝试 SSH 登录节点失败 | 节点不提供客户主机登录入口,应使用 kubeconfig 连接集群。 |
API Server 使用平台提供的网址,不占用企业 EIP,不需要通过自行申请 EIP 或创建业务端口转发来连接。
进一步处理
按获取 kubeconfig 并连接集群重新核对操作步骤。必要时查看集群监控与组件日志,记录发生时间及错误信息后提交问题反馈。
反馈时不要提交完整 kubeconfig、认证令牌或主机私钥。
Last updated on
Was this page helpful?
