CI/CD / 系统课时

用变量和上下文读取运行数据

用变量和上下文读取运行数据

工作流经常需要知道当前仓库、触发事件、分支或 Runner 环境,再决定命令参数和输出内容。本节用一个可验证的工作流区分 env 与常用 contexts,并掌握表达式读取运行时数据的正确位置。

学习目标

  • 使用工作流、Job 和 Step 级 env 定义并读取环境变量
  • 从 github、runner 等 contexts 获取仓库、事件与 Runner 信息
  • 区分表达式求值与 Shell 环境变量展开,避免把两套语法混用

env 与 contexts 解决不同的数据来源

env 适合保存由工作流作者定义的数据,例如部署环境名、构建模式或重复使用的参数。它可以定义在工作流、Job 或 Step 层级;作用域越小的同名变量会覆盖外层值。

contexts 则由 GitHub Actions 在运行时提供。常用的 github context 描述当前工作流触发信息,例如 github.repository、github.event_name、github.ref 和 github.sha;runner context 描述执行机器,例如操作系统和临时目录。

env 与 contexts 数据进入步骤的关系

在工作流中读取运行数据

下面的完整工作流同时读取自定义变量和运行时 context。将它保存为 .github/workflows/runtime-data.yml,然后通过 Actions 页面手动运行。

yaml
name: Runtime data demo

on:
  workflow_dispatch:

env:
  APP_ENV: staging

jobs:
  inspect:
    runs-on: ubuntu-latest
    env:
      LOG_LEVEL: info
    steps:
      - name: Print runtime data
        env:
          REPOSITORY: ${{ github.repository }}
          EVENT_NAME: ${{ github.event_name }}
          RUNNER_OS: ${{ runner.os }}
        run: |
          echo "APP_ENV=$APP_ENV"
          echo "LOG_LEVEL=$LOG_LEVEL"
          echo "REPOSITORY=$REPOSITORY"
          echo "EVENT_NAME=$EVENT_NAME"
          echo "RUNNER_OS=$RUNNER_OS"

预期输出

text
APP_ENV=staging
LOG_LEVEL=info
REPOSITORY=<OWNER>/<REPOSITORY>
EVENT_NAME=workflow_dispatch
RUNNER_OS=Linux

其中 <OWNER>/<REPOSITORY> 会随实际仓库变化。这里先用表达式 ${{ github.repository }} 等读取 contexts,再通过 Step 级 env 注入 Shell,因此 run 中可以统一使用 $REPOSITORY 这样的 Bash 环境变量语法。

理解表达式与 Shell 展开时机

${{ ... }} 是 GitHub Actions 表达式语法,由工作流系统解析;$APP_ENV 则是 Bash 在 Runner 执行命令时展开的环境变量。二者虽然最终都能把值送进命令,但求值位置不同。

例如 if、with、env 等工作流字段经常直接使用 ${{ github.ref }};进入 run 后,已经注入环境的值通常直接按当前 Shell 的变量语法读取。Windows PowerShell 的环境变量语法则是 $env:APP_ENV,不能机械照搬 Bash 的 $APP_ENV。

选择数据来源

当数据是工作流自己定义且多个步骤需要复用时,优先使用 env;当数据描述本次触发、仓库、提交或 Runner 时,从相应 context 读取。需要把 context 值交给脚本时,可以先映射到 Step 级 env,这样脚本与 GitHub Actions 表达式之间的边界更清晰。

实际编写工作流时,可以先问“这个值是谁提供的”:作者提供的数据放入变量,平台提供的运行数据从 context 读取,再只把脚本真正需要的字段传入执行环境。

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

目录与阅读设置

阅读设置

17

记录一个想法

用变量和上下文读取运行数据

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

登录哪都通