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 描述执行机器,例如操作系统和临时目录。

在工作流中读取运行数据
下面的完整工作流同时读取自定义变量和运行时 context。将它保存为 .github/workflows/runtime-data.yml,然后通过 Actions 页面手动运行。
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"预期输出
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 读取,再只把脚本真正需要的字段传入执行环境。