Jenkins基础教程（149）Jenkins远程启动参数化构建作业：Jenkins远程操控：参数化构建让流水线“随机应变”-优快云博客

每次手动修改Jenkins配置的日子太苦了？试试参数化构建，让效率翻倍！

什么是参数化构建？Jenkins的“点菜”艺术

简单来说，参数化构建就是在Jenkins任务中添加一系列可配置的参数，这些参数可以在构建开始时由用户输入或通过API传递，从而影响构建的过程和行为。

想象一下：你去咖啡店点单，不再是只能选择固定套餐，而是可以自由选择咖啡种类、糖度、冰量等参数，最终得到符合你个人口味的咖啡。Jenkins的参数化构建正是如此，它让同一个Job可以根据不同参数执行不同的操作。

在企业中，要实现敏捷开发，必须结合Jenkins的众多插件来实现更强大的特性。通过参数化构建，我们可以获取构建人员究竟想根据参数做什么操作，提前在shell脚本中做好对应的判断。

为什么你的Jenkins需要参数化构建？

提高灵活性：通过参数化构建，我们可以根据不同的需求提供可配置的参数，动态调整构建的配置和行为。
减少重复Job：在没有使用参数化构建之前，可能需要为每个环境（开发、测试、生产）创建单独的Job，导致Job数量庞大，管理和维护困难。
降低出错风险：每次构建项目时如果都需要修改配置，不仅麻烦，还容易出错。参数化构建通过标准化输入降低了这种风险。
实现更复杂的流程控制：结合条件判断和参数，可以实现根据不同的参数值执行不同的构建步骤，甚至实现高级流程控制和自定义逻辑。

参数化构建基础：Jenkins的“调味料”大全

在Jenkins中配置参数化构建非常简单。你可以在任务的配置中添加参数化构建的选项，并定义参数的类型和值。

Jenkins提供了多种参数类型，像是一个专业厨房的各种调味区：

字符串参数：用于输入文本，如版本号、文件路径等
布尔参数：复选框，用于启用或禁用特定的构建步骤
选项参数：下拉列表，提供多个选项供用户选择
文本参数：多行文本输入，适合需要输入大量文本的场景
密码参数：专门用于处理敏感信息，如密码、API密钥等
文件参数：允许用户上传文件作为构建的一部分

在Pipeline中定义参数

对于Pipeline类型的Job，我们可以在Jenkinsfile中直接定义参数：

pipeline {
    agent any
    parameters {
        string(name: 'VERSION', defaultValue: '1.0.0', description: '构建版本')
        booleanParam(defaultValue: false, description: '是否启用调试模式', name: 'DEBUG_MODE')
        choice(
            choices: ['dev', 'test', 'staging', 'production'],
            description: '选择部署环境',
            name: 'DEPLOY_ENV'
        )
        text(name: 'DEPLOY_TEXT', defaultValue: 'One\nTwo\nThree', description: '部署说明')
        password(name: 'API_TOKEN', defaultValue: '', description: 'API令牌')
    }
    stages {
        stage('Debug') {
            steps {
                script {
                    if (params.DEBUG_MODE) {
                        sh "printenv"
                    } else {
                        echo "调试模式未开启"
                    }
                }
            }
        }
        stage('Deploy') {
            steps {
                script {
                    echo "正在部署版本 ${params.VERSION} 到 ${params.DEPLOY_ENV} 环境"
                    if (params.DEPLOY_ENV == 'dev') {
                        echo "执行开发环境部署"
                    } else if (params.DEPLOY_ENV == 'test') {
                        echo "执行测试环境部署"
                    } else if (params.DEPLOY_ENV == 'staging') {
                        echo "执行预生产环境部署"
                    } else if (params.DEPLOY_ENV == 'production') {
                        echo "执行生产环境部署"
                    }
                }
            }
        }
    }
}

在Pipeline中，我们通过params.参数名的方式引用参数。

需要注意的是，在Pipeline中定义参数后，需要手动执行一次Pipeline，参数定义才会生效。