如何将GitHub Actions任务路由至不同类型的自托管运行器？

核心结论 #

• A：完全可以实现按任务类型将Actions路由到不同的自托管运行器
• B：你当前的企业版账户已经支持runner组功能，无需升级付费
• C：该方案完全可行

关于Runner组UI不可见的问题 #

企业版下看不到runner组的配置界面，几乎都是权限不足导致：

• 必须拥有企业、组织或仓库的管理员权限，才能访问runner组的设置入口
• 检查你的账户角色，确认在对应层级（企业、组织或目标仓库）拥有管理自托管运行器的权限

任务路由的两种实现方案 #

方案1：使用Runner组（企业版推荐） #

Runner组可以将同类型的自托管运行器归类，通过组来统一分配任务，适合多仓库共享运行器的场景：

1. 创建并配置Runner组：
   • 进入企业GitHub设置→Actions→Runner组，创建两个组（比如gpu-runners和large-cpu-runners）
   • 将GPU运行器添加到gpu-runners组，大CPU运行器添加到large-cpu-runners组
   • 配置组的访问权限，允许你的目标仓库使用这些组
2. 在Workflow中指定Runner组：
   在runs-on中同时指定self-hosted和组名称即可：

   jobs:
     # CUDA测试任务（路由到GPU运行器组）
     cuda-test:
       runs-on: [self-hosted, gpu-runners]
       steps:
         - name: Execute CUDA tests
           run: ./run-cuda-tests.sh
   
     # 大CPU/磁盘任务（路由到大CPU运行器组）
     cpu-heavy-job:
       runs-on: [self-hosted, large-cpu-runners]
       steps:
         - name: Run CPU-intensive tasks
           run: ./cpu-heavy-script.sh
   

方案2：使用Runner标签（细粒度控制） #

如果不需要组级别的权限管理，给每个自托管运行器添加专属标签，直接在Workflow中指定标签更灵活：

1. 给运行器添加标签：
   • 注册运行器时，通过--labels参数添加标签：

     # 注册GPU运行器时添加标签
     ./config.sh --url https://github.com/your-enterprise/your-repo --token YOUR_REG_TOKEN --labels gpu,cuda-12
     # 注册大CPU运行器时添加标签
     ./config.sh --url https://github.com/your-enterprise/your-repo --token YOUR_REG_TOKEN --labels 32-core,1tb-disk
     

   • 已注册的运行器也可以在GitHub UI的运行器管理页面修改标签
2. 在Workflow中指定标签：

   jobs:
     cuda-test:
       runs-on: [self-hosted, gpu, cuda-12]
       steps:
         - name: Run CUDA tests
           run: ./run-cuda-tests.sh
   
     cpu-heavy-job:
       runs-on: [self-hosted, 32-core, 1tb-disk]
       steps:
         - name: Execute CPU-heavy tasks
           run: ./cpu-heavy-script.sh
   

注意事项 #

• 确保运行器处于在线状态，且Workflow中的组名/标签与配置完全匹配（区分大小写）
• 企业版中，runner组适合统一管理多仓库的运行器访问权限；标签则更适合单仓库内的任务细粒度分配
• 若仍无法看到runner组UI，请联系企业管理员确认你的权限配置

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