咨询GitLab Runner的active与online scope及同名status的区别

调用场景与命令 #

在调用GitLab API获取项目Runner列表时，对scope和status参数中的active、online含义存在疑问，使用的调用命令如下：

curl --header "PRIVATE-TOKEN:${KEY}" "https://<git-url>/api/v4/projects/<pid>/runners?scope=active&status=online"

参数含义解析 #

1. scope参数的active与online区别

• scope=active：表示Runner已完成激活流程，且与当前项目（或GitLab实例）保持关联，处于可用状态。只要Runner未被手动禁用、取消关联，就会被归为active，无论它当前是否在线。
• scope=online：表示Runner当前正与GitLab服务器维持实时连接，随时可以接收并执行任务。所有online的Runner必然是active的，但active的Runner可能因为网络问题、进程停止等原因处于离线状态。

2. status参数的同名值是否与scope含义一致

status参数中的active、online和scope参数的对应值含义完全相同，二者的差异仅在于筛选维度：

• scope侧重于Runner的激活/关联状态（是否具备被调用的资格）
• status侧重于Runner的实时连接状态（是否能立刻响应任务）

组合使用这两个参数时，比如示例中的命令，会筛选出已激活且当前处于在线状态的项目专属Runner。

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