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

这篇讲流水线已经触发、任务却一直停在等待中时怎么查出卡在哪一层。看完你可以按任务旁边的等待原因逐项核对运行器是否在线、执行模式、标签、资源和并发并决定是改任务还是改运行器。运行器Runner是装在构建机上、领取并执行任务的程序。流水线和运行器在团队版和企业版中提供社区版没有CI/CD菜单本文的操作不适用。列表里一台运行器都没有时先登录 AngusGit侧栏进入CI/CD → 运行器点新增 Runner。控制面地址改成构建机访问得到的地址名称例如build-linux-01点生成令牌1 小时内有效只显示一次。任务要在容器里跑时页签选Docker 一键拉起标签填linux,docker。任务要直接在构建机上跑时页签选Zip 安装标签不要带docker机器上先装好 JDK 21。把命令复制到构建机执行列表里变成空闲再回到流水线看等待原因。1. 运行器是怎么被挑中的每个任务在 YAML 里用runner说明自己要什么样的运行器例如pipeline:build:runner:mode:DOCKERimage:repo.anguskit.com/docker-public/angus-ci-maven:21labels:[linux,docker]steps:-name:Buildrun:mvn-B-ntp clean package-DskipTestsAngusGit 在所有运行器里按下面的顺序一层层筛选。哪一层筛完一台都不剩任务就停在那一层等待原因写的就是那一层在线只看状态是在线、空闲或忙碌的运行器。离线和已禁用的不参与。执行模式任务写了mode时运行器的模式要和它相同。运行器的模式在它第一次接入时按标签确定带docker标签的是 DOCKER不带的是 NATIVE。任务没写mode时这一层不筛。标签任务labels里列出的每一个标签运行器都要有。运行器多出来的标签没关系。资源任务写了resources时运行器上报的 CPU、内存要够。并发运行器手上的任务数要小于它的最大并发 Job 数。剩下的运行器里AngusGit 会选当前最空闲的一台。2. 先看等待原因打开CI/CD → 流水线点流水线名称在运行记录里点这次运行的序号进入运行详情。在任务页签里停在等待中的任务旁会显示一行原因。后面五节按这五种原因逐项对照。标签对不上时等待原因原文是「没有同时具备标签 linux, docker 的 Runner」。模式对不上是「没有匹配执行模式 DOCKER 的 Runner」一台都没在线是「没有在线的 Runner」资源不够是「没有满足资源要求的 Runner」并发满了是「匹配的 Runner 并发已满正在等待空闲槽位」。对照当前实例时dev-1和priv-1都是空闲所以页面上没有停在等待中的任务原因原文仍是上面这几句对得上就能按后面各节改。还没触发时也能提前发现问题。在流水线上点触发后如果此时没有任何在线、空闲或忙碌的运行器页面会提示没有可调度的 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 方式接了一台宿主机运行器标签里没有dockermode: 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 两种任务吗能。每个任务各写各的runnerAngusGit 按任务分别挑运行器。前提是两种运行器都有在线的。我刚改了运行器的标签已经在等待的任务会自动领走吗会。等待中的任务会隔一小段时间重新匹配一次标签对上之后就会被领走不需要重新触发。稍等片刻刷新运行详情即可。小结任务停在等待中先看运行详情里写的等待原因。AngusGit 依次检查在线、执行模式、标签、资源和并发原因写的就是在哪一层筛空了。离线的运行器去构建机上恢复被禁用的点启用执行模式在运行器接入时由docker标签决定DOCKER 任务要带它的运行器NATIVE 任务要不带它的任务的每个标签都要在同一台运行器上大小写一致资源要求不要超过机器总量并发已满就是在排队等一等或者扩容。结论任务停在等待中时按运行详情旁显示的等待原因依次核对运行器是否在线、接入时的执行模式DOCKER/NATIVE、是否包含任务要求的全部labels区分大小写、资源上限与并发槽位。参考文章AngusGit 手册运行器管理AngusGit 手册流水线基础流水线运行器怎么接到构建机在那台机器上执行接入命令流水线任务在哪跑Docker 容器还是宿主机