CI/CD / 系统课时
在步骤和作业间传递输出
在步骤和作业间传递输出
流水线经常需要让前一个阶段计算版本号、镜像标签或构建结果,再交给后续阶段使用。本节通过 step output 与 job output 建立明确的数据出口,让值既能在同一 Job 内复用,也能跨 Job 沿依赖关系传递。
学习目标
- 使用
$GITHUB_OUTPUT为步骤设置输出值 - 通过
steps.<id>.outputs在同一 Job 中读取输出 - 将 step output 映射为 job output,并通过
needs在其他 Job 中读取
Step output 解决同一 Job 的传值
步骤需要先设置 id,后续表达式才能按 ID 引用它。向 GitHub Actions 提供步骤输出时,将 名称=值 追加到 $GITHUB_OUTPUT 指向的环境文件。
下面先生成版本号,再在同一个 Job 的下一步骤读取它。
name: step-output
on:
workflow_dispatch:
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Generate version
id: version
shell: bash
run: echo "value=1.4.0" >> "$GITHUB_OUTPUT"
- name: Read version
run: echo "version=${{ steps.version.outputs.value }}"预期输出
version=1.4.0version 是步骤 ID,value 是输出名称,因此读取路径是 steps.version.outputs.value。输出属于步骤上下文,不应把它误认为普通 Shell 环境变量。
Job output 把值暴露给下游
Step output 默认只在当前 Job 的 steps 上下文中可用。另一个 Job 运行在独立的 Runner 环境中,不能直接读取 steps.version.outputs.value。要跨 Job 传值,需要先在生产者 Job 的 outputs 中把步骤输出映射成 Job output。
name: job-output
on:
workflow_dispatch:
jobs:
build:
runs-on: ubuntu-latest
outputs:
release_version: ${{ steps.version.outputs.value }}
steps:
- name: Generate version
id: version
shell: bash
run: echo "value=1.4.0" >> "$GITHUB_OUTPUT"
deploy:
needs: build
runs-on: ubuntu-latest
steps:
- name: Read build output
run: echo "deploying=${{ needs.build.outputs.release_version }}"预期输出
deploying=1.4.0这里形成两次映射:步骤先产生 value,build.outputs.release_version 再把它公开为 Job 输出,最后 deploy 通过 needs.build.outputs.release_version 读取。

记住两条读取路径
同一 Job 内读取步骤输出时,路径从 steps 开始:steps.<step_id>.outputs.<output_name>。跨 Job 读取时,路径从 needs 开始:needs.<job_id>.outputs.<output_name>。
跨 Job 的消费者还必须通过 needs 声明对生产者的依赖,否则生产者 Job 不属于消费者的 needs 上下文。needs 因而同时承担执行顺序和数据依赖两个职责。
输出适合传小型结果
Job output 很适合版本号、镜像标签、布尔判断、资源 ID 等短小结果。如果阶段之间需要传递编译产物、压缩包或测试报告,output 并不是文件传输机制,应改用 artifact 等适合保存和下载文件的方式。
实际设计流水线时,可以把每个 Job 看成具有明确输入和输出的阶段:步骤负责计算值,Job 明确暴露下游真正需要的数据,再由 needs 建立消费关系。这样比依赖 Runner 上偶然存在的文件或环境变量更清晰,也更容易维护。