怎么在Linux利用Jenkins-Wait-Until-Project-Is-Built实现多任务间的流水线依赖同步-linux运维-PHP中文网

jenkins无“jenkins-wait-until-project-is-built”官方插件，但可通过原生build(wait: true)阻塞触发、pipeline轮询或共享文件通知实现job间依赖同步，推荐优先使用内建build(wait: true)机制。

怎么在linux利用jenkins-wait-until-project-is-built实现多任务间的流水线依赖同步

Jenkins 本身不提供名为 Jenkins-Wait-Until-Project-Is-Built 的官方插件或内置功能。这个名称看起来像是对某第三方插件的误记、混淆，或是自定义脚本的命名——在 Jenkins 官方插件库（https://www.php.cn/link/7a04fdcf6f0e51992c2dfd7cfd3e99aa。

但你的核心诉求非常明确：在 Linux 环境下，利用 Jenkins 实现多个任务（Job）之间的依赖同步，即“等待上游 Job 构建完成后再触发下游 Job”。这是典型的跨 Job 流水线协调问题，有成熟、稳定、推荐的实现方式。

下面分三类场景给出直接可用的方案：

1. 同一 Jenkins 实例内 Job 间的可靠等待（推荐）

使用 Build Trigger + Trigger builds remotely 或 Pipeline Utility Steps 插件配合 input/waitUntil 是最轻量且可控的方式。

✅ 前提：确保已安装 Pipeline Utility Steps 插件（管理插件中搜索安装）

✅ 推荐写法（声明式流水线）：

pipeline {
  agent any
  stages {
      stage('Wait for upstream-job') {
          steps {
              script {
                  def buildNumber = null
                  // 轮询上游 Job 状态，最多等 30 分钟，每 30 秒查一次
                  waitUntil {
                      try {
                          def job = jenkins.model.Jenkins.instance.getItemByFullName('upstream-job')
                          if (job) {
                              def lastBuild = job.lastBuild
                              if (lastBuild && lastBuild.result == 'SUCCESS') {
                                  buildNumber = lastBuild.number
                                  return true
                              }
                          }
                      } catch (e) {
                          echo "检查 upstream-job 异常: ${e.message}"
                      }
                      sleep(30)
                      return false
                  }
                  echo "上游 job 成功构建，构建号: ${buildNumber}"
              }
          }
      }
      stage('Continue downstream work') {
          steps {
              echo '开始执行下游逻辑...'
              // 比如拉取产物、部署等
          }
      }
  }
}

⚠️ 注意：该方式需 Jenkins 主节点有足够权限读取其他 Job 状态（默认有），且不依赖外部工具。

2. 使用原生 Pipeline 触发机制（更标准、更推荐）

避免轮询，改用 Jenkins 内置的 build step 触发并等待（支持跨项目、带参数、自动阻塞）：

VLAN Linux Client

管理 VLAN.CN Linux 客户端的安装、登录、组网连接、服务控制及网络诊断操作。

下载

stage('Trigger and wait for deploy-service') {
    steps {
        script {
            def result = build(
                job: 'deploy-service',
                parameters: [
                    string(name: 'VERSION', value: env.BUILD_NUMBER),
                    booleanParam(name: 'SKIP_TEST', value: true)
                ],
                wait: true,     // ← 关键：阻塞直到完成
                propagate: true // ← 关键：上游失败则本 Job 失败
            )
            echo "deploy-service 执行完毕，结果: ${result.result}"
        }
    }
}

✅ 优势：无需轮询、语义清晰、失败自动传递、支持参数传递、日志可追溯。

3. 多分支/多仓库场景下的解耦依赖（适合微服务）

若上游是多分支流水线（Multibranch Pipeline），下游需等「特定分支」构建完成，可结合：

上游 Job 在成功后调用 curl 推送通知（如写入共享文件、发 HTTP webhook 到下游 Jenkins）；
下游使用 Generic Webhook Trigger 插件监听事件；
或更简单：上游在构建成功后，用 sh 命令在 NFS 共享目录中生成标记文件（如 /shared/ready-deploy-feature-123），下游用 sh 'test -f /shared/ready-deploy-feature-123' + waitUntil 检查。

示例（上游结尾）：

sh 'echo "built at $(date)" > /shared/ready-${env.BRANCH_NAME}-${env.BUILD_NUMBER}'

下游等待：

waitUntil {
    sh 'ls /shared/ready-feature-123-* > /dev/null 2>&1 && exit 0 || exit 1'
    return true
}

✅ 适用：跨 Jenkins 实例、异构环境、需解耦强依赖的生产场景。

不复杂但容易忽略的是：轮询不是必须的，Jenkins 原生 build(wait: true) 已完全满足绝大多数同步需求；所谓“等待插件”，往往是旧版 Freestyle 项目时代为弥补能力缺失而做的补丁，现代声明式 Pipeline 中应优先使用内建机制。