Alaya NeW Cloud
集群连接问题排查

使用 kubectl 无法连接集群时,可依次检查集群状态、配置文件、凭据和 API Server 网络访问。本文介绍常见问题的处理方法。

检查集群状态

  1. 在集群管理中查看目标集群状态。
  2. 创建中或删除中的集群只能查看,不能连接。
  3. 集群异常时,可尝试页面允许的连接或监控入口,并记录错误提示。

本企业尚未开通集群时,应通过资源开通与变更咨询了解开通方式。已有集群但列表无结果时,先清除筛选条件。

检查 kubeconfig

  • 确认使用的是目标集群最新获取的 kubeconfig,而非其他环境或其他集群的配置。
  • 在命令中显式指定配置文件路径,避免本地默认配置指向其他集群。
  • 检查本地文件是否完整保存,不要手工替换认证信息或猜测 API Server 地址。

以下示例中的路径需要替换为实际配置文件路径:

kubectl --kubeconfig /path/to/kubeconfig cluster-info

按错误类型排查

现象建议处理
认证失败或提示凭据失效返回目标集群页面重新获取连接信息,再使用新配置连接。
请求超时或无法解析地址核对 kubeconfig 中的 API Server 地址,以及本地网络对该地址的访问条件。
提示权限不足核对目标企业、集群和当前使用的连接信息,并反馈具体被拒绝的操作。
使用集群节点 IP 无法 SSH 登录集群节点不提供客户 SSH / Web 访问,应使用 kubeconfig 连接集群。

API Server 使用平台提供的随机网址,不占用 EIP。Service 公网端口转发用于业务访问,不能替代或修复 Kubernetes API 连接。

收集排查信息

需要进一步排查时,可结合集群监控与组件日志,记录问题发生时间和错误提示。

反馈方式请参见问题反馈。无需提交完整 kubeconfig、认证令牌或私钥。

Last updated on

Was this page helpful?

On this page