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 的下一步骤读取它。

yaml
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 }}"

预期输出

text
version=1.4.0

version 是步骤 ID,value 是输出名称,因此读取路径是 steps.version.outputs.value。输出属于步骤上下文,不应把它误认为普通 Shell 环境变量。

Job output 把值暴露给下游

Step output 默认只在当前 Job 的 steps 上下文中可用。另一个 Job 运行在独立的 Runner 环境中,不能直接读取 steps.version.outputs.value。要跨 Job 传值,需要先在生产者 Job 的 outputs 中把步骤输出映射成 Job output。

yaml
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 }}"

预期输出

text
deploying=1.4.0

这里形成两次映射:步骤先产生 value,build.outputs.release_version 再把它公开为 Job 输出,最后 deploy 通过 needs.build.outputs.release_version 读取。

Step output 到 Job output 的数据传递链

记住两条读取路径

同一 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 上偶然存在的文件或环境变量更清晰,也更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

在步骤和作业间传递输出

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

登录哪都通