Jenkins声明式Pipeline动态生成parallel并行阶段实现咨询

报错根因 #

你遇到的Expected a block for parallel报错本质是声明式Pipeline的语法解析机制导致的：

• 声明式Pipeline在编译期就会校验语法结构，parallel指令要求编译期就能识别到明确的代码块，直接传入运行时才会执行返回结果的parallelJobs()方法，编译阶段无法感知到合法的块结构，直接抛出语法错误
• 你之前构造的返回值是阶段数组，而Jenkins并行执行要求的结构是键为分支展示名、值为执行闭包的Map结构，数组格式本身也不符合参数要求
• 此前尝试的声明式+脚本式混合方案BlueOcean展示异常，是因为完全用脚本逻辑生成整个流水线结构，脱离了声明式的标准语法树，BlueOcean无法解析渲染阶段层级。

兼容BlueOcean的可行实现 #

不需要改动声明式Pipeline的整体使用方式，借助声明式原生支持的script步骤在运行时动态构造并行分支Map即可，所有阶段都可以在BlueOcean中正常展示，支持每个分支内嵌套多个阶段。
共享库中的代码调整如下：

def accounts() {
  return ["dynamic", "list"]
}

def call() {
  pipeline {
    agent any
    stages {
      stage('Build all variations') {
        steps {
          script {
            // 初始化parallel要求的Map结构
            def parallelBranches = [:]
            // 遍历动态列表生成每个并行分支
            accounts().each { account ->
              parallelBranches[account] = {
                // 分支内可自由定义多个阶段，BlueOcean可正常识别渲染
                stage("构建 ${account}") {
                  echo "执行构建步骤: $account"
                }
                stage("测试 ${account}") {
                  echo "执行测试步骤: $account"
                }
              }
            }
            // 触发并行执行
            parallel parallelBranches
          }
        }
      }
    }
  }
}

方案说明 #

• 完全符合声明式Pipeline语法规范，不会触发编译期语法错误：script是声明式官方支持的嵌入脚本逻辑的入口，外层结构在编译期完全合法，动态生成分支的逻辑在运行时执行
• BlueOcean兼容性良好：外层是标准声明式结构，分支内的stage遵循声明式阶段定义规则，视图中可以正常展示每个并行分支、分支内子阶段的执行状态、日志
• 保留声明式Pipeline的全部特性：顶层的options、environment、post等配置可以正常使用，单个并行分支内也可以单独指定agent、环境变量、后置操作等配置

注意事项 #

• 并行分支闭包中引用的变量尽量使用字符串、数字等可序列化类型，避免触发Jenkins序列化报错
• 如果需要对失败分支做单独处理，可以给parallel方法传入failFast: true/false参数控制快速失败策略
• 单个并行分支内如果需要指定独立的运行节点、环境变量，直接在分支内的stage块中声明即可，配置规则和普通声明式阶段完全一致

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