Jenkins 中通过 Extended Choice Parameter Plugin 实现多选框式业务分组发布,安装插件后配置复选参数,构建脚本解析选项驱动部署,参数一次传入、结构清晰、可追溯。

在 Linux 环境下用 Jenkins 的 Build With Parameters 实现多选框式业务分组发布,核心是借助 Extended Choice Parameter Plugin 插件提供复选能力,并在构建脚本中解析所选项,驱动对应服务或环境的部署逻辑。整个过程不依赖外部调用,参数一次传入、结构清晰、可追溯。
安装并启用 Extended Choice Parameter 插件
该插件是实现多选框的必要前提:
- 进入 Manage Jenkins → Manage Plugins → Available,搜索 Extended Choice Parameter 并安装
- 安装后无需重启 Jenkins(多数现代版本支持热加载),但建议确认插件状态为“已启用”
- 若 Jenkins 版本较旧(如 sudo systemctl restart jenkins
配置多选参数:定义业务分组列表
在 Job 配置页勾选 This project is parameterized,点击 Add Parameter → Extended Choice Parameter,设置以下关键项:
-
Name:例如
SERVICE_GROUPS(全大写+下划线,便于 Shell 脚本引用) - Description:如 “勾选需发布的业务分组(支持多选)”
- Type:选择 Check boxes
-
Choices:每行一个分组标识,例如:
payment-service<br> user-center<br> order-api<br> notification-svc
(注意:不要加引号、空格或逗号分隔;换行即分隔) -
Default Value(可选):填入预设项,如
payment-service,user-center(逗号分隔,无空格)
在构建脚本中解析并执行分组部署
Jenkins 会将用户勾选的多个值以英文逗号拼接的字符串形式注入环境变量(如 $SERVICE_GROUPS)。Linux 下 Shell 脚本需做标准化处理后循环操作:
- 先去除首尾空格和引号:
SERVICE_GROUPS=$(echo "$SERVICE_GROUPS" | sed 's/^["'\'']\+//; s/["'\'']\+$//') - 再将逗号转为空格,便于 for 循环:
for svc in $(echo "$SERVICE_GROUPS" | tr ',' ' '); do - 每个
$svc就是实际选中的分组名,可用来触发对应部署动作,例如:if [ "$svc" = "payment-service" ]; then ansible-playbook deploy-payment.yml -e "env=prod"; fiif [ "$svc" = "order-api" ]; then ./deploy.sh --service order-api --tag v2.5.0; fi
验证与调试建议
首次配置时推荐加入日志输出,确保参数解析准确:
- 在构建步骤开头添加 Shell 命令:
echo "Selected groups: [$SERVICE_GROUPS]" - 构建完成后查看 Console Output,确认输出类似:
Selected groups: [payment-service,user-center] - 检查构建历史页的 Parameters 区域,可回溯每次构建具体勾选了哪些分组
- 若某分组未触发部署,优先排查 Shell 中的字符串匹配是否大小写/空格一致(如
"Payment-Service"≠"payment-service")


















