Alaya NeW Cloud
为什么集群无法连接或连接凭据失效

使用 kubectl 连接失败时,应分别检查集群状态、kubeconfig 指向、认证凭据及本地到 API Server 的网络条件。集群可见不代表已经具备连接条件。

排查步骤

  1. 在集群管理中确认目标集群的状态。创建中或删除中的集群仅供查看;异常集群按页面可用入口排查。
  2. 返回目标集群的连接入口,获取当前连接信息。不要混用其他企业或其他集群的 kubeconfig。
  3. 使用实际文件路径显式指定 kubeconfig,确认本地客户端连接的是目标集群。
  4. 如提示凭据失效或认证失败,重新获取连接信息后再连接;短期凭据的有效时间以页面提示为准。
  5. 如仍无法连接,按下表中的错误现象继续检查。

以下命令中的路径应替换为实际 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?

On this page