You need to enable JavaScript to run this app. EKS集群部署Jenkins时Kubernetes云测试连接失败如何解决
优惠活动
大模型
产品
解决方案
定价
更多

EKS集群部署Jenkins时Kubernetes云测试连接失败如何解决

问题排查解决步骤

1. 优先核对RBAC配置错误

你提供的RBAC配置存在两处核心匹配问题:

  • 你的RoleBinding是命名空间级别资源,仅能在RoleBinding自身部署的命名空间下生效,无法跨命名空间赋予权限。如果你的Jenkins需要管理多命名空间资源或者跨命名空间访问K8s API,请将RoleBinding替换为ClusterRoleBinding,配置参考如下:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: jenkins
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: jenkins
subjects:
- kind: ServiceAccount
  name: jenkins
  # 替换为Jenkins实际部署的命名空间,和ServiceAccount所在命名空间保持一致
  namespace: jenkins
  • 检查ServiceAccount的部署命名空间是否和ClusterRoleBinding中指定的命名空间一致:你当前的ServiceAccount配置未指定metadata.namespace,默认会部署到kubectl当前上下文的命名空间(大概率是default),和原RoleBinding中写的jenkins命名空间不匹配,会导致权限绑定失败。

2. 核对Jenkins部署配置

确认Jenkins的Deployment配置中已正确引用ServiceAccount:

spec:
  template:
    spec:
      # 必须和你创建的ServiceAccount名称完全一致
      serviceAccountName: jenkins

3. 核对Kubernetes云插件配置

Jenkins测试连接配置

  • 如果Jenkins部署在集群内部,Kubernetes地址直接填https://kubernetes.default.svc.cluster.local即可,无需填写EKS的公网API地址
  • 采用ServiceAccount方式认证时,无需手动填写「Kubernetes 服务证书 key」和「凭据」,Jenkins Pod会自动挂载ServiceAccount的CA证书和token,手动填写错误值会直接导致认证失败
  • 确认「Kubernetes 命名空间」填写的是你预期部署Jenkins Agent的命名空间,如果你仍用RoleBinding而非ClusterRoleBinding,需要对应在该命名空间下单独配置权限绑定。

4. 权限与连通性校验

  • 执行以下命令校验ServiceAccount权限是否生效,将占位符替换为实际命名空间:
kubectl auth can-i list pods --as=system:serviceaccount:<Jenkins部署命名空间>:jenkins -n <Agent部署命名空间>

如果返回no则说明权限绑定未生效,重新检查RBAC配置。

  • 进入Jenkins Pod内部测试K8s API连通性:
kubectl exec -it <Jenkins Pod名称> -n <Jenkins命名空间> -- curl -k https://kubernetes.default.svc.cluster.local

如果请求超时,检查集群网络策略、安全组是否允许Jenkins Pod访问K8s API的443端口。

5. 日志排查

如果上述步骤仍未解决问题,查看Jenkins系统日志中测试连接时的报错信息:

  • 报403无权:回到RBAC配置核对权限范围和绑定关系
  • 报连接超时:排查网络、EKS安全组配置
  • 报证书错误:核对Kubernetes地址配置,删除手动填写的证书配置项

内容的提问来源于stack exchange,提问作者Gowmi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 07:45:04