- name
- jenkins
- description
- |
Jenkins 构建助手
快速使用
查看所有项目：
Jenkins 项目列表或
列出所有 Jenkins job触发构建（默认分支）：
构建 <项目名>触发构建（指定分支）：
构建 <项目名> <分支名>或
构建 <项目名> 分支=<分支名>查看构建状态：
<项目名> 构建状态认证配置（安全）
配置方式（二选一）
方式一：环境变量（推荐，安全）
在运行脚本前设置以下环境变量：
# 方式 A: 使用 API Token（推荐）
export JENKINS_URL="http://jks.huimei-inc.com"
export JENKINS_USERNAME="jiaofu"
export JENKINS_API_TOKEN="your_api_token_here"
# 方式 B: 使用用户名密码（API Token 过期时回退）
export JENKINS_URL="http://jks.huimei-inc.com"
export JENKINS_USERNAME="jiaofu"
export JENKINS_PASSWORD="your_password_here"方式二：Shell 配置文件（永久生效）
将上述环境变量添加到 ~/.zshrc 或 ~/.bash_profile：
# Jenkins 构建助手认证信息
export JENKINS_URL="http://jks.huimei-inc.com"
export JENKINS_USERNAME="jiaofu"
export JENKINS_API_TOKEN="your_api_token_here"然后执行：
source ~/.zshrc # 或 source ~/.bash_profile获取 Jenkins API Token
- 登录 Jenkins: http://jks.huimei-inc.com
- 点击右上角用户名 → "Configure"（配置）
- 在 "API Token" 区域点击 "Add new Token"
- 复制生成的 Token 到环境变量
认证优先级
- 优先使用 API Token（更安全，可随时撤销）
- 回退到用户名密码（仅当 API Token 失效时）
⚠️ 安全提示：切勿将密码、API Token 提交到版本控制系统（如 git）。使用 .env 文件或系统环境变量存储敏感信息。核心功能
1. 列出所有项目
返回 Jenkins 中所有可用的 job 名称列表。
2. 触发构建
用户指定项目名称后自动触发构建，支持：
- 精确项目名匹配
- 模糊匹配（包含关键词的项目）
- 指定构建分支（支持多种格式）
3. 构建结果
构建完成后返回：
- ✅ 成功：程序包下载地址（OSS 链接）
- ❌ 失败：失败原因和异常信息
使用示例
用户：Jenkins 项目列表
助手：可用项目：
- hospital__go_crf_service
- hospital__java_omc-business
...
用户：构建 hospital__go_crf_service cloud_251230_release
助手：🔄 正在触发 hospital__go_crf_service 构建...
使用默认参数: ['HM_ENV', 'REMOTE_HOST', 'PROJECT_TYPE', 'PROJECT_NAME', 'GIT_URL', 'BRANCH_TAG', 'IMAGE_NAME']
🔀 指定分支: cloud_251230_release
✅ 构建已触发，等待构建完成...
✅ hospital__go_crf_service 构建成功！
构建号: #71
耗时: 65.3秒
📦 程序包下载地址：
1. http://ovf.oss-cn-hangzhou.aliyuncs.com/package%2Fpython%2Fcrf_service%2F...支持的分支指定格式
| 格式 | 示例 |
|---|---|
| 空格分隔 | 构建 hospital__go_crf_service cloud_251230_release |
| 分支=参数 | 构建 hospital__go_crf_service 分支=cloud_251230_release |
| branch=参数 | 构建 hospital__go_crf_service branch=cloud_251230_release |
注意事项
- 构建可能需要几分钟时间，请耐心等待
- 如果构建失败，会显示具体的错误日志
- 程序包下载链接通常为 OSS 格式
- 分支名必须是该 job 支持的 git 分支或 tag