如何在GitHub Actions工作流中动态加载变量文件？

你目前在GitHub Actions里把所有环境变量混写在workflow的env字段中，确实会随着变量和环境增多变得难以维护。可以参考Ansible的思路，保留「每个环境对应单独YAML变量文件」的结构，通过以下方式在GitHub Actions中实现动态加载：

步骤1：保留变量文件结构 #

继续使用vars/var_dev.yml、vars/var_qa.yml这类按环境划分的YAML文件，每个文件存储对应环境的变量：

# vars/var_dev.yml
hostname: "mydevhost"
port: "1885"
mount: "D:\"
# ... 其他变量

步骤2：编写GitHub Actions工作流 #

利用yq工具解析YAML文件，并将变量注入到GitHub Actions的环境中，具体工作流示例如下：

name: 部署工作流
on: 
  push:
  workflow_dispatch:
    inputs:
      myenv:
        type: choice
        options:
          - dev
          - qa
          - uat
          - prod
          - dr

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码仓库
        uses: actions/checkout@v4

      - name: 动态加载目标环境变量
        run: |
          # 使用yq将YAML转换为键值对格式，写入GitHub环境变量
          while IFS="=" read -r key value; do
            echo "$key=$value" >> "$GITHUB_ENV"
          done < <(yq eval -o=env vars/var_${{ github.event.inputs.myenv }}.yml)

      - name: 验证变量加载效果
        run: |
          echo "当前环境主机名: $hostname"
          echo "当前环境端口: $port"
          echo "当前环境挂载路径: $mount"

方案优势 #

• 和你熟悉的Ansible变量管理逻辑完全一致，学习成本低
• 每个环境的变量独立存储，新增/修改变量或环境只需操作对应YAML文件，无需改动工作流核心代码
• yq会自动处理变量中的特殊字符（如空格、引号），避免手动拼接引发的错误

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