Jenkins Kubernetes插件拉取Git私有仓库代理Pod凭证传递问题咨询

你遇到的报错核心原因是Jenkins控制器侧存储的凭证默认不会自动同步到Kubernetes集群内动态启动的代理Pod中，jnlp容器无法读取控制器的凭证存储，导致识别不到指定ID的凭证，拉取私有代码库时认证失败。

1. 全局开启Kubernetes插件凭证传递 #

进入Jenkins控制台 → 系统管理 → 云 → 对应Kubernetes云配置页：

• 点击「高级」展开隐藏配置
• 开启将控制器凭证传递到代理选项
• 保存配置后重启所有正在运行的代理Pod生效

如果你使用声明式流水线，也可以单独为某个流水线开启传递，无需修改全局配置：

pipeline {
  agent {
    kubernetes {
      defaultContainer 'jnlp'
      passThroughCredentials true
    }
  }
  // 其余流水线逻辑不变
}

2. 流水线内显式注入凭证 #

如果不需要全局开启凭证传递，可直接在拉取代码的逻辑外层包裹凭证注入块：

withCredentials([usernamePassword(
  credentialsId: 'b4f86bce-18c3-4758-972d-5907e601efd0',
  usernameVariable: 'GIT_USERNAME',
  passwordVariable: 'GIT_PASSWORD'
)]) {
  git url: 'https://gitlab.mycompany.eu/myuser/myproject.git',
      branch: 'feature-jenkins-deployment'
}

3. Gitlab Branch Source插件专属配置 #

如果是多分支流水线使用Gitlab Branch Source插件自动生成Job，无需修改每个Jenkinsfile：

• 进入对应多分支流水线配置页 → 「源」配置栏
• 确认「凭证」下拉框选择的是ID为b4f86bce-18c3-4758-972d-5907e601efd0的Gitlab访问凭证
• 找到「克隆选项」配置，开启使用凭证克隆开关
• 保存后重新扫描分支，插件会自动将凭证注入到代理Pod的运行环境中

注意：所有凭证必须通过Jenkins凭证中心管理，禁止明文写入Jenkinsfile或任何代码仓库，避免凭证泄露。

内容的提问来源于stack exchange，提问作者KrisztiánPál Klucsik