CI/CD / 系统课时
让不同阶段运行在不同节点
让不同阶段运行在不同节点
当编译、测试和部署需要不同操作系统、工具链或权限时,不应让整条流水线绑定同一个 Jenkins Agent。本节把三个阶段分配到独立节点,并解决节点切换后工作目录不共享导致的产物传递问题。
学习目标
- 为不同 Stage 使用标签选择对应 Jenkins Agent
- 理解 Stage 切换节点时 Workspace 为什么不能直接共享
- 使用
stash与unstash在节点之间传递流水线产物
为什么要按阶段选择节点
Declarative Pipeline 可以在顶层设置 agent none,取消整条流水线的统一 Agent,再为每个 stage 单独声明 agent。例如编译节点安装 JDK,测试节点提供测试工具,而部署节点只开放必要的生产访问权限。
这种隔离不仅解决工具版本冲突,也能缩小权限范围。部署凭据和生产网络没有必要暴露给负责普通编译的节点。

为每个阶段声明 Agent
下面的 Jenkinsfile 假定 Jenkins 已经存在三个可用节点,并分别配置 build、test、deploy 标签。示例用文本文件模拟构建产物,因此可以直接观察跨节点传递过程。
pipeline {
agent none
stages {
stage('Compile') {
agent { label 'build' }
steps {
sh 'printf "artifact-v1\\n" > app.jar'
stash name: 'compiled-app', includes: 'app.jar'
}
}
stage('Test') {
agent { label 'test' }
steps {
unstash 'compiled-app'
sh 'test -s app.jar && echo "tests passed"'
stash name: 'tested-app', includes: 'app.jar'
}
}
stage('Deploy') {
agent { label 'deploy' }
steps {
unstash 'tested-app'
sh 'printf "deploying: "; cat app.jar'
}
}
}
}预期输出
tests passed
deploying: artifact-v1实际 Jenkins 日志还会包含节点分配、Workspace 路径和 Pipeline 步骤等内容,因此完整输出会更多;上面只列出示例命令产生的关键结果。
节点切换后怎样传递文件
每个 Agent 使用自己的 Workspace。即使三个 Stage 属于同一次构建,test 节点也不能假定能看到 build 节点磁盘上的 app.jar。这正是示例在 Compile 后执行 stash、在 Test 中执行 unstash 的原因。
stash 适合在同一次 Pipeline Run 的不同阶段之间暂存和恢复一组文件。includes 使用 Ant 风格包含模式;实际项目可以传递类似 target/*.jar 或 dist/** 的结果。对于很大的构建产物,不宜把 stash 当长期制品仓库,应考虑 Artifact Manager 或外部制品仓库。
验证阶段是否真的被隔离
排查节点分配时,可以临时在每个阶段输出节点名和工作目录。下面是可独立放进某个 steps 中的片段示例,依赖 Jenkins Pipeline 提供的 NODE_NAME 和 WORKSPACE 环境变量。
sh 'echo "node=$NODE_NAME workspace=$WORKSPACE"'预期输出
node=<NODE_NAME> workspace=<PATH><NODE_NAME> 与 <PATH> 取决于实际 Jenkins 节点和 Workspace。检查三个 Stage 的日志,应看到它们被调度到符合各自标签的节点;同时删除任一必要的 unstash 后,对应节点不应再依赖其他节点的本地文件。这样才能确认流水线真正实现了执行环境与产物传递的解耦。