如何在GitHub Actions中通过vars上下文动态定义Runner？

问题原因 #

你遇到的核心问题是环境变量的加载时机晚于runs-on字段的解析时机：

• GitHub Actions在解析作业的runs-on配置时，还未加载你指定的TEST环境，此时vars.RUNNER会被解析为空值，触发报错。
• 直接写runs-on: self-hosted时，不需要依赖环境变量，作业可以正常初始化；后续执行阶段加载环境后，才能读取到环境变量并输出。

解决方案 #

方案1：将变量改为仓库变量（推荐） #

如果不需要将RUNNER变量与特定环境绑定，把它移到仓库级变量中，就能在runs-on解析阶段被读取：

1. 进入仓库的 Settings → Secrets and variables → Variables → Repository variables
2. 添加变量RUNNER，值设为self-hosted
3. 修改工作流文件，直接使用仓库变量：

name: Dynamic Runner Test
on: [push]

jobs:
  greeting_job:
    runs-on: ${{ vars.RUNNER }}
    environment: TEST # 依然可以绑定TEST环境，不影响其他环境变量的读取
    steps:
      - name: Print all variables
        run: |
          echo "Runner from repo var: ${{ vars.RUNNER }}"
          echo "Env var from TEST: ${{ vars.YOUR_OTHER_VAR }}"

方案2：通过前置作业传递环境变量（适合必须用环境变量的场景） #

如果RUNNER必须绑定到TEST环境，可以先通过一个前置作业读取环境变量，再将其传递给后续作业的runs-on：

name: Dynamic Runner with Env Var
on: [push]

jobs:
  # 前置作业：读取TEST环境的RUNNER变量并输出
  fetch_runner:
    runs-on: ubuntu-latest # 先用官方托管的runner执行
    environment: TEST
    outputs:
      runner: ${{ vars.RUNNER }}
    steps:
      - name: Export runner variable
        run: echo "runner=${{ vars.RUNNER }}" >> $GITHUB_OUTPUT

  # 主作业：使用前置作业传递的runner值
  greeting_job:
    needs: fetch_runner
    runs-on: ${{ needs.fetch_runner.outputs.runner }}
    environment: TEST
    steps:
      - name: Print variables
        run: |
          echo "Runner from env var: ${{ needs.fetch_runner.outputs.runner }}"
          echo "Other env vars: ${{ vars.YOUR_OTHER_VAR }}"

内容的提问来源于stack exchange，提问作者donahj07