如何在Jenkins中点击任务时即时加载GitHub中的参数属性文件

前置条件 #

• 安装Jenkins的Active Choices Plugin，这是实现动态参数的核心插件
• 确保Jenkins服务器能正常访问目标GitHub仓库（私有仓库需提前配置GitHub个人访问令牌作为凭证）

配置步骤 #

1. 配置参数化构建 #

进入目标Jenkins任务的配置页，找到参数化构建过程，点击「添加参数」，选择Active Choices Reactive Parameter（若无需参数联动，选Active Choices Parameter即可）。

2. 编写Groovy脚本拉取属性文件 #

针对每个需要动态生成的参数（environment、Testcases、Servers），编写Groovy脚本直接从GitHub拉取jenkins_parameter.properties的最新内容并解析选项。

示例脚本（以environment参数为例）

// 替换为你的GitHub文件原始地址（必须用raw.githubusercontent.com的直链）
def propsRawUrl = "https://raw.githubusercontent.com/[用户名]/[仓库名]/[分支名]/jenkins_parameter.properties"
// 拉取文件内容
def propsContent = new URL(propsRawUrl).getText()
// 筛选出environment对应的行并拆分选项
def envLine = propsContent.split("\n").find { it.trim().startsWith("environment=") }
def envOptions = envLine.split("=")[1].split(",")
return envOptions

私有仓库适配

如果是私有仓库，建议通过Jenkins凭证管理存储令牌，避免硬编码泄露，示例如下：

// 从Jenkins凭证中获取GitHub令牌
def token = credentials('github-token-id')
def propsRawUrl = "https://${token}@raw.githubusercontent.com/[用户名]/[仓库名]/[分支名]/jenkins_parameter.properties"
// 后续解析逻辑同上

3. 批量配置其他参数 #

按照相同逻辑，分别为Testcases和Servers创建Active Choices参数，只需修改脚本中筛选行的条件（比如it.trim().startsWith("Testcases=")）即可。

4. 验证效果 #

保存配置后点击「立即构建」，Jenkins会在加载参数选择界面时，即时从GitHub拉取最新的属性文件内容，生成对应的参数选项，完全满足点击任务时即时读取的需求。

注意事项 #

• 务必使用GitHub文件的原始直链（raw.githubusercontent.com开头），不要用仓库网页地址
• 私有仓库的凭证请通过Jenkins凭证管理存储，避免硬编码泄露
• 可在脚本中添加异常处理逻辑，防止网络波动导致参数加载失败

内容的提问来源于stack exchange，提问作者A Prakash