CI/CD / 系统课时

让不同阶段运行在不同节点

让不同阶段运行在不同节点

当编译、测试和部署需要不同操作系统、工具链或权限时,不应让整条流水线绑定同一个 Jenkins Agent。本节把三个阶段分配到独立节点,并解决节点切换后工作目录不共享导致的产物传递问题。

学习目标

  • 为不同 Stage 使用标签选择对应 Jenkins Agent
  • 理解 Stage 切换节点时 Workspace 为什么不能直接共享
  • 使用 stash 与 unstash 在节点之间传递流水线产物

为什么要按阶段选择节点

Declarative Pipeline 可以在顶层设置 agent none,取消整条流水线的统一 Agent,再为每个 stage 单独声明 agent。例如编译节点安装 JDK,测试节点提供测试工具,而部署节点只开放必要的生产访问权限。

这种隔离不仅解决工具版本冲突,也能缩小权限范围。部署凭据和生产网络没有必要暴露给负责普通编译的节点。

编译测试部署阶段在不同 Jenkins Agent 间执行并传递产物

为每个阶段声明 Agent

下面的 Jenkinsfile 假定 Jenkins 已经存在三个可用节点,并分别配置 build、test、deploy 标签。示例用文本文件模拟构建产物,因此可以直接观察跨节点传递过程。

groovy
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'
            }
        }
    }
}

预期输出

text
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 环境变量。

groovy
sh 'echo "node=$NODE_NAME workspace=$WORKSPACE"'

预期输出

text
node=<NODE_NAME> workspace=<PATH>

<NODE_NAME> 与 <PATH> 取决于实际 Jenkins 节点和 Workspace。检查三个 Stage 的日志,应看到它们被调度到符合各自标签的节点;同时删除任一必要的 unstash 后,对应节点不应再依赖其他节点的本地文件。这样才能确认流水线真正实现了执行环境与产物传递的解耦。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让不同阶段运行在不同节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通