jenkins pipeline 中可用 input 指令实现含部署说明的人工确认弹窗，通过 message（支持 html 标签）、parameters（如 booleanparam/stringparam）、submitter（限定角色）及动态注入（sh/readfile）组合使用，确保信息清晰、操作可控、审计可追溯。
在 Jenkins Pipeline 中，使用 input 指令可以实现人工确认步骤，并支持自定义消息、参数和提交人信息。要实现“包含部署说明的人工确认弹窗”，关键在于合理组织 input 的 message、id、parameters 和 submitter 等字段，让运维或发布人员在点击确认前清晰了解本次部署内容。
基础用法：带说明的 input 弹窗
最简方式是直接在 stage 中使用 input，将部署说明写入 message 字段（支持简单 HTML 标签，如 <br>、<b></b>）：
stage('Confirm Deployment') {
steps {
script {
input message: '''<b>⚠️ 即将执行生产环境部署</b><br><u>本次变更内容：</u><br>
• 更新用户服务至 v2.4.1<br>
• 同步数据库 schema（新增 user_status 字段）<br>
• 回滚预案：执行 rollback.sh 脚本<br><u>请确认已：</u><br>
✓ 完成预发验证<br>
✓ 通知相关方停更时间窗口（22:00–22:15）''',
id: 'prod-deploy-confirm',
submitter: 'ops-team,release-manager',
ok: '✅ 我已阅读并确认执行'
}
}
}
增强可读性：用 parameters 添加结构化输入项
仅靠 message 不够严谨，可配合 parameters 让操作人主动勾选或填写关键项，避免“习惯性点确认”：
- 用
booleanParam强制勾选“我已核对回滚方案” - 用
stringParam要求填写本次发布的 ticket ID 或变更单号 - 用
choiceParam限定部署范围（如all/zone-a-only）
示例：
input message: '请确认以下部署信息并填写必要字段：',
parameters: [
booleanParam(name: 'ACK_ROLLBACK_PLAN', defaultValue: false, description: '✅ 我已确认回滚脚本可用且已测试'),
stringParam(name: 'CHANGE_ID', defaultValue: '', description: 'Jira/Tapd 变更单号（必填）'),
choiceParam(name: 'DEPLOY_SCOPE', choices: ['all', 'zone-a-only', 'canary-5%'], description: '部署范围')
]
绑定上下文：动态注入部署说明
实际项目中，部署说明往往来自 Git 提交记录、Changelog 文件或上游构建参数。可在 input 前用 sh 或 readFile 提取并拼接：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
script {
def changelog = sh(script: 'git log -n 3 --oneline', returnStdout: true).trim()
def desc = "本次部署基于分支 ${env.GIT_BRANCH}，最近 3 条提交：\n${changelog}"
input message: """<b>? 部署摘要</b><br>${desc.replace('\n', '<br>')}""",
id: "deploy-${env.BUILD_NUMBER}"
}
注意：readFile 更适合读取项目内 CHANGELOG.md，而 sh 更适合解析 Git 元数据。
权限与审计：限制提交人 + 记录确认者
通过 submitter 限定可操作角色（Jenkins 用户组或 LDAP 组），并用 input 返回值捕获确认人信息：
def userInput = input(
message: '确认上线？',
submitter: 'devops-admins,qa-leads',
parameters: [booleanParam(name: 'APPROVED', description: '本人承担本次发布责任')]
)
echo "由 ${userInput.user} 于 ${new Date()} 确认，输入：${userInput.APPROVED}"
该信息会记录在 Jenkins 构建日志和 Blue Ocean 界面中，满足合规审计要求。
不复杂但容易忽略的是 message 的换行与语义分层——多用
、、，少用长段落；把“风险提示”“前置检查”“回滚路径”分块呈现，能显著降低误操作率。
