Jenkins Job Builder (JJB) 静态作业配置文件的参数注入方案咨询

我完全懂你的需求——已经有一套能正常生成作业和文件夹的JJB YAML配置，但想在运行jenkins-jobs test/update时灵活注入一些参数（比如文件夹前缀、测试节点、分支名），又不想用JJB自带的defaults机制，怕和现有配置冲突对吧？下面结合你尝试过的方法，给你梳理可行的解决方案，顺便解决你遇到的!include报错问题：

先解决你用!include时的解析错误问题 #

你之前的报错都是因为!include的使用位置不符合JJB和YAML的语法要求：

• 不能把!include插在键值对的中间（比如你尝试在dynamic-config块里直接插!include）
• 要include整个带锚点的配置块，得保证include的文件是完整的YAML结构

举个正确的例子：

1. 新建dynamic-config.yaml.inc文件，内容直接是带锚点的完整块：

- dynamic-config: &dynamic-config
    name: "dynamic-config"
    folder-prefix: "experimental/"
    node: "test-node"

2. 在主作业配置文件的最开头直接引用这个include：

!include: dynamic-config.yaml.inc
# 后面的内容就可以直接用*dynamic-config锚点了

如果是include单个参数值（比如你后来成功的那种），要确保include的文件里只有纯字符串内容，比如folder-prefix.inc里就写experimental/，不要加引号或其他YAML结构，否则会解析失败。

满足你“运行时动态传参”需求的最优方案 #

既然你想要类似--define的命令行传参效果，又不想用defaults，推荐两种更灵活的方式：

1. 环境变量+JJB插值（最接近你的预期）

JJB支持在YAML里直接引用环境变量，用${ENV_VAR:-默认值}的格式（冒号后面是可选的默认值）。

• 先修改你的作业配置，把需要动态配置的参数替换成环境变量引用：

- dynamic-config: &dynamic-config
    folder-prefix: "${FOLDER_PREFIX:-experimental/}"
    node: "${NODE_NAME:-test-node}"
    branch-name: "${BRANCH_NAME:-main}"

• 运行JJB时直接在命令行设置环境变量即可：

# 测试环境
FOLDER_PREFIX="experimental/" NODE_NAME="test-node" jenkins-jobs test -r jobfolder
# 生产环境
FOLDER_PREFIX="" NODE_NAME="prod-node" BRANCH_NAME="release" jenkins-jobs update -r jobfolder

这种方式完全不需要额外配置文件，直接通过命令行传递参数，还能保留默认值，完美避免defaults冲突。

2. 多配置文件夹切换（你最初想到的方案）

如果偏好用配置文件来区分环境，可以把不同环境的参数做成独立的配置文件夹：

• 新建experimental/config.yaml：

- env-config: &env-config
    folder-prefix: "experimental/"
    node: "test-node"

• 新建production/config.yaml：

- env-config: &env-config
    folder-prefix: ""
    node: "prod-node"

• 作业配置里直接用*env-config引用这些参数
• 运行时指定对应的配置文件夹+作业文件夹：

# 用实验环境配置
jenkins-jobs test -r experimental:jobfolder
# 用生产环境配置
jenkins-jobs update -r production:jobfolder

JJB会加载指定目录下的所有YAML，只要不同环境的配置文件里锚点名称一致（比如都叫env-config），作业配置完全不用修改，切换目录就切换了环境参数。

关于你提到的类似问题 #

目前JJB确实没有官方的--define参数来直接传递变量，所以上面的环境变量或多配置文件夹是社区里最常用的替代方案。其中环境变量的方式最贴合你想要的“命令行传参”需求，推荐优先尝试。

备注：内容来源于stack exchange，提问作者frans