GitHub Action自托管Runner无法响应环境标签动态配置问题

问题根源 #

这不是自托管Runner的已知Bug，核心问题出在GitHub Actions对runs-on标签的解析逻辑上：

• 直接写runs-on: [self-hosted, dev1]时，解析器会将其识别为两个独立标签，Runner需同时具备这两个标签才能承接任务。
• 通过变量传递self-hosted, dev1这类字符串时，GitHub会把整个字符串当成单个带逗号的标签，日志里显示的Requested labels: self-hosted, dev1其实是一个完整标签名，你的Runner显然没有这个带逗号的标签，所以无法匹配。
• 直接在runs-on: [${{ vars.xxx }}]里用变量会报错，是因为Workflow初始化阶段会先做语法校验，此时变量还未被渲染，解析器判定括号内的变量格式不合法。

可行解决方案 #

方案1：JSON数组+fromJSON解析

修改setup步骤的输出，将标签序列化为JSON数组格式，再在runs-on中用fromJSON解析为标签数组：

name: Dashboard - Publish and deploy
on:
  workflow_dispatch:
    inputs:
      environment:
        type: environment
        description: Select the environment
      buildConfiguration:
        # 保留你的原有配置

jobs:
  setup:
    name: Setup runner labels for deploy
    runs-on: ubuntu-latest
    environment: ${{ inputs.environment }}
    outputs:
      deployrunner: ${{ steps.step1.outputs.deployrunner }}
    steps:
      - name: Set runs-on for deploy
        id: step1
        run: |
          # 将逗号分隔的标签转为JSON数组
          labels=$(echo "${{ vars.DEPLOYSERVER }}" | tr ',' '\n' | jq -R . | jq -s .)
          echo "deployrunner=$labels" >> $GITHUB_OUTPUT

  build:
    # 保留你的原有配置
        
  deployDashboard:
    needs: [build, setup]
    # 用fromJSON将输出的JSON字符串转为标签数组
    runs-on: ${{ fromJSON(needs.setup.outputs.deployrunner) }}
    name: Deploy dashboard to server
    environment: ${{ inputs.environment }}
    env:
      ServiceBaseDir: ${{ vars.DASHBOARD_DIR }}  
    steps:     
      # 保留你的原有部署步骤

方案2：拆分多输出变量

如果不想用JSON，可在setup步骤中拆分标签为多个输出变量，再在runs-on中直接组合：

name: Dashboard - Publish and deploy
on:
  workflow_dispatch:
    inputs:
      environment:
        type: environment
        description: Select the environment
      buildConfiguration:
        # 保留你的原有配置

jobs:
  setup:
    name: Setup runner labels for deploy
    runs-on: ubuntu-latest
    environment: ${{ inputs.environment }}
    outputs:
      runner-label1: ${{ steps.step1.outputs.runner-label1 }}
      runner-label2: ${{ steps.step1.outputs.runner-label2 }}
    steps:
      - name: Set runs-on for deploy
        id: step1
        run: |
          # 拆分逗号分隔的标签为两个变量
          IFS=',' read -r label1 label2 <<< "${{ vars.DEPLOYSERVER }}"
          echo "runner-label1=$label1" >> $GITHUB_OUTPUT
          echo "runner-label2=$label2" >> $GITHUB_OUTPUT

  build:
    # 保留你的原有配置
        
  deployDashboard:
    needs: [build, setup]
    # 用变量组合标签数组
    runs-on: [${{ needs.setup.outputs.runner-label1 }}, ${{ needs.setup.outputs.runner-label2 }}]
    name: Deploy dashboard to server
    environment: ${{ inputs.environment }}
    env:
      ServiceBaseDir: ${{ vars.DASHBOARD_DIR }}  
    steps:     
      # 保留你的原有部署步骤

验证要点 #

• 检查setup步骤的日志，确认输出的标签格式正确（JSON数组需为["self-hosted","dev1"]，多变量需分别输出单个标签）。
• 确保自托管Runner同时具备self-hosted和dev1两个标签。

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