这篇讲流水线已经触发、任务却一直停在 **等待中** 时，怎么查出卡在哪一层。看完你可以按任务旁边的等待原因，逐项核对运行器是否在线、执行模式、标签、资源和并发，并决定是改任务还是改运行器。运行器（Runner）是装在构建机上、领取并执行任务的程序。

流水线和运行器在团队版和企业版中提供；社区版没有 **CI/CD** 菜单，本文的操作不适用。

列表里一台运行器都没有时，先登录 AngusGit，侧栏进入 **CI/CD → 运行器**，点 **新增 Runner**。**控制面地址** 改成构建机访问得到的地址，名称例如 `build-linux-01`，点 **生成令牌**（1 小时内有效，只显示一次）。任务要在容器里跑时，页签选 **Docker 一键拉起**，标签填 `linux,docker`。任务要直接在构建机上跑时，页签选 **Zip 安装**，标签不要带 `docker`，机器上先装好 JDK 21。把命令复制到构建机执行，列表里变成 **空闲**，再回到流水线看等待原因。

## 1. 运行器是怎么被挑中的

每个任务在 YAML 里用 `runner` 说明自己要什么样的运行器，例如：

```yaml
pipeline:
  build:
    runner:
      mode: DOCKER
      image: repo.anguskit.com/docker-public/angus-ci-maven:21
      labels: ["linux", "docker"]
    steps:
      - name: Build
        run: mvn -B -ntp clean package -DskipTests
```

AngusGit 在所有运行器里，按下面的顺序一层层筛选。哪一层筛完一台都不剩，任务就停在那一层，等待原因写的就是那一层：

1. **在线：** 只看状态是 **在线**、**空闲** 或 **忙碌** 的运行器。**离线** 和 **已禁用** 的不参与。
2. **执行模式：** 任务写了 `mode` 时，运行器的模式要和它相同。运行器的模式在它第一次接入时，按标签确定：带 `docker` 标签的是 DOCKER，不带的是 NATIVE。任务没写 `mode` 时，这一层不筛。
3. **标签：** 任务 `labels` 里列出的每一个标签，运行器都要有。运行器多出来的标签没关系。
4. **资源：** 任务写了 `resources` 时，运行器上报的 CPU、内存要够。
5. **并发：** 运行器手上的任务数，要小于它的 **最大并发 Job 数**。

剩下的运行器里，AngusGit 会选当前最空闲的一台。

![任务按在线、执行模式、标签、资源和空闲并发逐层筛选运行器](https://developer.qcloudimg.com/http-save/yehe-1099973/e52aef93d790fa66e4709b796852cd3b.svg)

## 2. 先看等待原因

打开 **CI/CD → 流水线**，点流水线名称，在 **运行记录** 里点这次运行的序号，进入运行详情。在 **任务** 页签里，停在 **等待中** 的任务旁会显示一行原因。后面五节按这五种原因逐项对照。

标签对不上时，等待原因原文是「没有同时具备标签 linux, docker 的 Runner」。模式对不上是「没有匹配执行模式 DOCKER 的 Runner」，一台都没在线是「没有在线的 Runner」，资源不够是「没有满足资源要求的 Runner」，并发满了是「匹配的 Runner 并发已满，正在等待空闲槽位」。对照当前实例时，`dev-1` 和 `priv-1` 都是空闲，所以页面上没有停在等待中的任务；原因原文仍是上面这几句，对得上就能按后面各节改。

![运行器列表：dev-1（NATIVE）和 priv-1（DOCKER）都空闲，并发 0/2](https://developer.qcloudimg.com/http-save/yehe-1099973/8fe2559605e2dc72d9c1a55d28c81dc4.png)

还没触发时也能提前发现问题。在流水线上点 **触发** 后，如果此时没有任何在线、空闲或忙碌的运行器，页面会提示 **没有可调度的 Runner**，说明是「当前没有在线或忙碌中的 Runner，触发后任务会一直等待分配。请先接入至少一台。」旁边有 **去接入 Runner** 的入口。

## 3. 没有在线的 Runner

等待原因是「没有在线的 Runner」时，说明所有运行器都处于 **离线** 或 **已禁用**。

- **离线：** 运行器每 15 秒发一次心跳，超过 90 秒没有心跳、连接也断了，就会变成 **离线**。常见原因是构建机关机、运行器进程或容器退出、构建机到 AngusGit 的网络断了。到构建机上检查：Docker 方式执行 `docker ps` 看容器还在不在，不在就 `docker start <容器名>`；Zip 方式到 `/opt/AngusRunnerAgent` 下重新执行 `./startup-agent.sh`。
- **已禁用：** 有人在列表里点了 **禁用**。禁用时的提示是「禁用后不再承接新任务，心跳也不会自动恢复」，所以机器恢复也没用，要在列表里点 **启用**。
- **一台都没有：** 还没接入过运行器。按开头在 **CI/CD → 运行器** 点 **新增 Runner**，把命令复制到构建机，等到列表里是 **空闲**。

## 4. 没有匹配执行模式 … 的 Runner

原因里写的是 DOCKER，说明没有带 `docker` 标签的在线运行器；写的是 NATIVE，说明在线的运行器都带了 `docker` 标签。DOCKER 任务要在运行器按镜像拉起的容器里执行；NATIVE 任务直接在构建机（宿主机）上执行。

| 任务写的 | 需要的运行器 | 常见情况 |
| --- | --- | --- |
| `mode: DOCKER` | 带 `docker` 标签 | 只用 Zip 方式接了一台宿主机运行器，标签里没有 `docker` |
| `mode: NATIVE` | 不带 `docker` 标签 | 只用 Docker 方式接了运行器，默认标签就是 `linux,docker` |

改法有两种：改任务的 `mode`，让它和现有运行器一致；或者再接入一台对应模式的运行器。

注意，运行器的模式只在第一次接入时确定。之后在 **编辑运行器** 里加上或去掉 `docker` 标签，改变的只是标签，模式不会跟着变。要换模式，就用对应的方式重新接入一台。

一台机器同时需要两种模式时，可以在上面装两个运行器：一个用 Docker 方式接入，一个用 Zip 方式接入且标签里不带 `docker`。

`mode` 只能写大写的 `DOCKER` 或 `NATIVE`。两种模式分别要哪种运行器，按本节上面的表格对照；还没有对应的那一台时，按开头用对应页签再接一台。

## 5. 没有同时具备标签 … 的 Runner

任务 `labels` 里的每一个标签，都要出现在同一台运行器上。原因里会列出任务要求的标签。

逐个对照：在 **CI/CD → 运行器** 列表里看每台在线运行器的标签。常见的不一致有三种：

- **少了一个标签。** 任务要 `["linux", "docker", "jdk21"]`，运行器只有 `linux,docker`。
- **大小写不一样。** `Linux` 和 `linux` 是两个不同的标签。
- **写法不一样。** 任务写 `x86`，运行器写的是 `amd64`。

改运行器的标签，不需要重装：在列表里打开 **编辑运行器**，修改 **标签** 后保存。或者反过来，把任务 YAML 里的标签改成和运行器一致。`docker` 这个标签例外，它和执行模式有关，见上一节。

## 6. 没有满足资源要求的 Runner

任务的 `runner.resources` 里写了 CPU 或内存要求，而在线的运行器里，没有一台上报的总量达到这个要求。原因后面的括号里，会写出任务要求的资源。

在 **CI/CD → 运行器** 里打开运行器详情，能看到这台机器的 CPU 和内存情况。改法是把任务的资源要求调到合理范围，或者接入一台配置更高的机器。不需要限制资源时，可以直接去掉 `resources`。

## 7. 匹配的 Runner 并发已满，正在等待空闲槽位

这不是配置错误。能接这个任务的运行器都在忙，手上的任务数已经达到 **最大并发 Job 数**，任务在排队。前面的任务结束后，它会自动开始。

经常排队时，有两种做法：

- **调大并发。** 在 **编辑运行器** 里调大 **最大并发 Job 数**，范围 1 到 64。先看运行器详情里的 CPU 和内存占用；机器已经很忙时，调大并发只会让每个任务都变慢。
- **再接一台。** 用相同的标签再接入一台运行器，任务会被分到更空闲的那台。

## 8. 任务接了又回到等待中

任务已经开始运行，过一会儿又变回 **等待中**。这通常是执行它的运行器中途断开了连接：AngusGit 发现连接断开后，会把这台运行器上正在执行的任务放回队列，重新挑一台运行器。只有这一台能接、它又没恢复时，等待原因会变成 **没有在线的 Runner**。按第 3 节检查那台机器。

## 常见问题

**任务没写 runner，会被派到哪里？**

不写 `mode` 也不写 `labels` 时，任何一台在线、还有空闲并发的运行器都可能领走它；任务也不会进容器，而是直接在运行器所在的环境里执行。为了结果可预期，建议每个任务都写明 `mode` 和 `labels`。

**一个流水线里能同时有 DOCKER 和 NATIVE 两种任务吗？**

能。每个任务各写各的 `runner`，AngusGit 按任务分别挑运行器。前提是两种运行器都有在线的。

**我刚改了运行器的标签，已经在等待的任务会自动领走吗？**

会。等待中的任务会隔一小段时间重新匹配一次，标签对上之后就会被领走，不需要重新触发。稍等片刻，刷新运行详情即可。

## 小结

任务停在 **等待中**，先看运行详情里写的等待原因。AngusGit 依次检查在线、执行模式、标签、资源和并发，原因写的就是在哪一层筛空了。离线的运行器去构建机上恢复，被禁用的点 **启用**；执行模式在运行器接入时由 `docker` 标签决定，DOCKER 任务要带它的运行器，NATIVE 任务要不带它的；任务的每个标签都要在同一台运行器上，大小写一致；资源要求不要超过机器总量；并发已满就是在排队，等一等或者扩容。

> **结论：** 任务停在 **等待中** 时，按运行详情旁显示的等待原因依次核对运行器是否 **在线**、接入时的执行模式（`DOCKER` / `NATIVE`）、是否包含任务要求的全部 `labels`（区分大小写）、资源上限与并发槽位。

## 参考文章

- [AngusGit 手册：运行器管理](https://www.anguskit.com/zh/docs/git/manual/12-runner-management)
- [AngusGit 手册：流水线基础](https://www.anguskit.com/zh/docs/git/manual/10-pipeline-basics)
- [流水线运行器怎么接到构建机：在那台机器上执行接入命令](https://www.anguskit.com/zh/blog/connect-pipeline-runner-to-build-machine)
- [流水线任务在哪跑：Docker 容器还是宿主机](https://www.anguskit.com/zh/blog/pipeline-runner-docker-vs-native)

这篇讲流水线已经触发、任务却一直停在 等待中 时，怎么查出卡在哪一层。看完你可以按任务旁边的等待原因，逐项核对运行器是否在线、执行模式、标签、资源和并发，并决定是改任务还是改运行器。运行器（Runner）是装在构建机上、领取并执行任务的程序。

运行器不接任务：标签、在线和并发对不上

流水线触发了，任务却一直停在「等待中」。AngusGit 会在任务旁写出等待原因：没有在线的 Runner、执行模式不匹配、标签不匹配、资源不够，或者并发已满。按这五种原因对照页面原文，就能看出是标签、在线状态还是并发对不上，以及该改任务还是改运行器。

编程语言

任务停在等待中，先查运行详情显示的等待原因。AngusGit依次筛选运行器是否在线、执行模式（DOCKER/NATIVE）、标签是否完全匹配（区分大小写）、资源是否足够、并发是否已满。离线运行器需在构建机恢复，禁用需启用，标签可编辑运行器修改，资源不足可调整要求或扩容，并发满则等待或加机器。

代码解释

容器

Docker

Linux

Agent

腾讯云双十一大促

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

运行器不接任务：标签、在线和并发对不上-腾讯云开发者社区-腾讯云

运行器不接任务：标签、在线和并发对不上

运行器不接任务：标签、在线和并发对不上

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐