如何强制一个Stage内的所有Job使用同一Agent工作目录？

API 探路者

2026-5-6

我之前帮团队解决过一模一样的问题——同一Stage里的Job偶尔能复用工作目录、偶尔不行，本质是CI/CD系统默认的工作空间隔离机制在搞鬼。下面给你几个能彻底解决的方案，分场景适用：

解决方案1：绑定固定Agent并指定自定义工作目录（适合Jenkins/自托管Runner场景）

如果你的流水线用的是固定节点Agent（不是动态生成的云节点），直接在Stage级别强制指定Agent和工作目录就能解决问题：

以Jenkins为例，在Stage配置里写：

stage('Your-Shared-Stage') {
  agent {
    node {
      label 'your-fixed-agent-label'
      customWorkspace '/absolute/path/to/your/shared-directory'
    }
  }
  jobs {
    // 这里放你的Job1、Job2、Job3
  }
}

这样整个Stage里的所有Job都会严格跑在指定Agent的指定目录下，完全复用之前Job产生的文件，不会出现不稳定的情况。
注意：如果用的是动态Agent（比如K8s Pod），这个方法不适用，因为Pod销毁后目录会被清空，得用下面的持久化方案。

解决方案2：用持久化存储卷共享目录（适合云原生CI/CD）

如果是GitHub Actions、GitLab CI这类云原生CI/CD工具，推荐挂载持久化存储卷来共享工作目录：

GitHub Actions：用自托管Runner的本地目录，或者给Runner挂载外部存储，然后在所有Job里指定同一个working-directory：

jobs:
  job1:
    runs-on: self-hosted
    working-directory: /mnt/shared-workspace
    steps:
      - uses: actions/checkout@v4
      # 你的任务步骤
  job2:
    runs-on: self-hosted
    needs: job1
    working-directory: /mnt/shared-workspace
    steps:
      # 直接复用job1生成的文件

GitLab CI：可以在Runner配置里挂载宿主机目录到容器，然后所有Job都使用这个挂载路径：

# runner配置文件
[[runners]]
  name = "Shared-Dir-Runner"
  executor = "docker"
  [runners.docker]
    volumes = ["/mnt/shared-workspace:/builds/shared"]

然后在.gitlab-ci.yml里指定工作目录：

stages:
  - shared-stage
job1:
  stage: shared-stage
  working_directory: /builds/shared
  script:
    - # 任务步骤
job2:
  stage: shared-stage
  needs: job1
  working_directory: /builds/shared
  script:
    - # 复用文件

解决方案3：强制Job串行+绑定同一Runner（轻量应急方案）

如果不想改太多配置，可以先让同一Stage的Job串行执行，并且绑定到同一个Runner：

核心是用needs（GitHub Actions/GitLab CI）或者buildAfterOtherBuilds（Jenkins）让Job按顺序执行，同时指定同一个Runner/Agent。这样Runner不会主动清理工作目录，后续Job就能复用之前的内容。
注意：这个方案只适合临时应急，长期来看还是前面两种方案更可靠，因为如果Runner被其他流水线占用，还是可能出现目录被覆盖的情况。

关键注意事项

不管用哪个方案，绝对不要让同一Stage的Job并行执行——并行的话哪怕在同一个Agent，也会因为资源竞争导致目录内容混乱，串行执行才能保证状态一致。
如果用的是云托管的官方Runner（比如GitHub的默认Runner），这类Runner是用完即销毁的，没法复用工作目录，必须切换到自托管Runner或者用存储卷方案。

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