选择 Runner 标签

本文档介绍 AtomGit 托管资源池和自托管 Runner 的标签类型对照以及全匹配和 default 等价两种匹配规则。

当你需要精确控制 job 在哪类 Runner 上执行——指定操作系统、架构、资源规格、或自定义特征（GPU、特定工具链）——需要理解标签匹配规则。

配置说明

标签类型对照

Runner 类型	标签格式	示例
AtomGit托管资源池	三段式 {os},{arch},{spec} 或组合标签	[ubuntu-latest, x64, small]
AtomGit托管资源池（默认）	default	default（等效 [ubuntu-latest, x64, small]）
自托管	self-hosted + 自定义标签	[self-hosted, linux, gpu]

匹配规则

规则一：全匹配

runs-on 中的所有标签必须同时存在于 Runner 的标签集合中，才视为匹配。

# Runner 标签集: {self-hosted, linux, x64, npu, cann}
# ✅ 匹配
runs-on: [self-hosted, linux, x64]
# ✅ 匹配
runs-on: [self-hosted, npu, cann]
# ❌ 不匹配（标签集中不含 pypto）
runs-on: [self-hosted, pypto]

规则二：default 等价

runs-on: default 等价于 runs-on: [ubuntu-latest, x64, small]。