首页/开发/CI/CD 与发布速查/Jenkins 凭据管理
工具链要点63 条

Jenkins 凭据管理

集中管理凭据:用户名密码、SSH 私钥、Secret 文本与文件;流水线通过 credentials() 或 withCredentials 绑定使用。

CI/CD 与发布速查开发更新于 2026-10-12
类型usernamePassword、sshPrivateKey、string、file
绑定environment { CRED = credentials('id') } 或 withCredentials
作用域系统/全局、文件夹级
掩码日志自动打码,输出仍要克制

注册表登录

注册表登录
steps {
  withCredentials([usernamePassword(credentialsId: 'registry',
                   usernameVariable: 'REG_USER', passwordVariable: 'REG_PASS')]) {
    sh 'docker login -u "$REG_USER" -p "$REG_PASS" registry.example.com'
  }
}
凭据掩码不是绝对防护:避免回显与产出包含凭据的文件,按最小范围授权。

易错点

  • 凭据 id 硬编码散落:轮换与迁移成本高
  • 作用域用错(系统级/文件夹级):流水线取不到值且报错含糊

数据来源与参考

  • Jenkins 手册《Using credentials》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌