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

1. 登录 Jenkins: http://jks.huimei-inc.com
2. 点击右上角用户名 → "Configure"（配置）
3. 在 "API Token" 区域点击 "Add new Token"
4. 复制生成的 Token 到环境变量

认证优先级

1. 优先使用 API Token（更安全，可随时撤销）
2. 回退到用户名密码（仅当 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