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，设置以下关键项：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

• 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"; fi
if [ "$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"）