首页/开发/CI/CD 与发布速查/Jenkins 参数化构建
工具链要点63 条

Jenkins 参数化构建

为流水线定义构建参数:字符串、布尔、选项、密码等;参数通过 params 访问,把可变输入从脚本里移出来。

CI/CD 与发布速查开发更新于 2026-10-12
类型string、text、booleanParam、choice、password
访问params.NAME
场景环境选择、演练开关、版本输入
注意参数定义变更后首次运行可能沿用旧值

参数与使用

参数与使用
pipeline {
  agent any
  parameters {
    choice(name: 'ENV', choices: ['staging', 'production'], description: '部署环境')
    booleanParam(name: 'DRY_RUN', defaultValue: true, description: '仅演练')
  }
  stages {
    stage('deploy') {
      steps { sh "./deploy.sh --env=${params.ENV} --dry-run=${params.DRY_RUN}" }
    }
  }
}
参数化 + 手动触发构成受控变更入口:危险选项的默认值放在保守侧。

易错点

  • 参数变更后首次运行沿用旧定义:需要通知使用者
  • 密码类型参数仍进入环境:高敏输入用凭据绑定替代

数据来源与参考

  • Jenkins 手册《Pipeline Syntax》(parameters)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌