Windows GitHub Runner可用Jinja2模板Action替代方案及兼容性判断方法

问题背景 #

我仓库中有如下包含待求值变量的文件：

cat infra/.env_qa

myname="Appone_${{ inputs.component }}"
port="8814"
server_list="{{ secrets.deploy_pass }}"
....

我原本使用Jinja模板Action生成新文件，配置如下：

- name: Setup env file
  uses: cuchi/jinja2-action@v1.2.0
  with:
    template: infra/.env_qa.j2
    output_file: infra/.env_qa

但该Action仅支持Linux环境，而我使用的是Windows runner，现咨询两个问题：

1. 支持Windows的Jinja模板替代Action；
2. 如何无需运行即可判断Action是否支持Windows。

解决方案 #

1. 支持Windows的Jinja模板替代Action

推荐两种跨平台（含Windows）的实现方式：

• samuelmeuli/action-jinja2：纯JavaScript实现的Action，完全跨平台，无需依赖特定系统环境。配置示例：

  - name: Generate env file with Jinja2
    uses: samuelmeuli/action-jinja2@v1.0.1
    with:
      template-file: infra/.env_qa.j2
      output-file: infra/.env_qa
      variables: |
        component: ${{ inputs.component }}
        deploy_pass: ${{ secrets.deploy_pass }}
  

• Python脚本替代：如果不想依赖第三方Action，可直接在Windows runner上安装Jinja2并执行脚本，灵活性更高。示例步骤：

  - name: Install Jinja2
    run: pip install jinja2
    shell: pwsh
  
  - name: Generate env file via Python
    run: |
      from jinja2 import Template
      import os
  
      with open("infra/.env_qa.j2", "r") as f:
          template = Template(f.read())
      
      output = template.render(
          component=os.environ["INPUT_COMPONENT"],
          deploy_pass=os.environ["SECRET_DEPLOY_PASS"]
      )
      
      with open("infra/.env_qa", "w") as f:
          f.write(output)
    env:
      INPUT_COMPONENT: ${{ inputs.component }}
      SECRET_DEPLOY_PASS: ${{ secrets.deploy_pass }}
    shell: python
  

2. 无需运行判断Action是否支持Windows的方法

• 检查Action的action.yml配置文件：进入Action的GitHub仓库，查看根目录下的action.yml（或action.yaml）：
  • 若runs.using为node16/node20，说明是JavaScript实现，天然支持Windows、Linux、macOS；
  • 若runs.using为docker，需确认镜像是否为多平台构建，若仅使用Linux镜像则不支持Windows；
  • 若runs.using为composite，需检查步骤中是否包含仅Linux支持的命令（如bash专属语法、Linux系统工具），有则不支持Windows。
• 查看Action的文档说明：多数Action会在README里明确标注支持的操作系统，比如Supported OS: Linux, Windows, macOS。
• 查看Action的测试工作流：进入仓库的.github/workflows目录，若存在针对Windows runner的测试用例，则说明支持Windows。

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