Pipeline中涉及的参数分为参数定义和配置参数两类。 ### 参数定义 在Pipeline中可使用`parameters`指令定义参数，常用参数类型有字符串参数（String）。例如，定义一个名为`DEPLOY_ENV`的字符串参数，默认值为`prod`，用于描述部署环境： ```groovy parameters { string(name: 'DEPLOY_ENV', defaultValue: 'prod', description: '部署环境') } ``` 此外，还可以定义其他类型的参数，如在示例中定义了字符串参数`branch`和选择参数`version`： ```groovy parameters { string(defaultValue: 'feature/v1.0.1', description: '请输入需要发布的分支', name: 'branch', trim: false) choice(choices: ['1.1', '1.2', '1.3'], description: 'select the version to test', name: 'version') } ``` ### 配置参数 Jenkins Pipeline的`options`部分可配置多种参数，具体如下： | 参数名 | 说明 | 例子 | | --- | --- | --- | | buildDiscarder | 保留最近历史构建记录的数量 | buildDiscarder(logRotator(numToKeepStr: '10')) | | checkoutToSubdirectory | 将代码从版本控制库中拉取后，保存在工作目录的子目录 | checkoutToSubdirectory('subdir') | | disableConcurrentBuilds | 禁用Jenkins同时执行多次该pipeline | disableConcurrentBuilds() | | newContainerPerStage | 当`agent`为Docker或Dockerfile时，每个`stage`都分别运行在一个新容器中 | newContainerPerStage() | | retry | pipeline发生失败后重试次数 | retry(4) | | timeout | pipeline运行超时时间 | timeout(time: 10, unit: 'HOURS') | 以下是包含配置参数的Pipeline示例： ```groovy pipeline { agent any options { buildDiscarder(logRotator(numToKeepStr: '10')) disableConcurrentBuilds() retry(4) timeout(time: 10, unit: 'HOURS') } stages { stage('demo') { steps { sh 'echo hello' } } } } ```