CI/CD / 系统课时

Job 一直排队怎么定位

Job 一直排队怎么定位

Workflow 已经触发但 Job 长时间显示 Queued 或 Waiting 时,说明问题已经越过事件触发层。此时应围绕“有没有合适的 Runner、标签能否匹配、是否被并发控制阻塞、是否在等待环境审批或保护条件”定位,而不是继续修改 on 触发规则。

学习目标

  • 根据 Job 状态判断 Runner、并发或环境等待问题
  • 检查 runs-on 与自托管 Runner 标签是否能够匹配
  • 识别 concurrency 和 Environment 保护规则造成的等待

先区分 Runner 排队和条件等待

一个 Job 从创建到真正执行,需要先满足配置约束,再获得能够接单的 Runner。GitHub 托管 Runner 和自托管 Runner 的排查重点不同;如果还配置了 concurrency 或受保护 Environment,Job 也可能因为前序运行或部署条件而等待。

Job 排队条件关系

最先查看 Job 页面给出的等待信息,因为它通常能区分“等待 Runner”和其他等待条件。不要仅凭 Queued 一个状态就认定 GitHub 托管 Runner 故障。

检查 runs-on 和 Runner 标签

GitHub 托管 Runner 使用 ubuntu-latest、windows-latest 等标签时,通常不需要自己维护机器。自托管 Runner 则必须存在一台同时满足 runs-on 所有标签要求的可用 Runner。

例如:

yaml
name: Self-hosted diagnostic

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: [self-hosted, linux, x64]
    steps:
      - name: Confirm runner
        run: echo "runner=${{ runner.name }} os=${{ runner.os }} arch=${{ runner.arch }}"

这是完整工作流,可从 Actions 页面手动运行。只有同时匹配 self-hosted、linux、x64 的 Runner 才能接收该 Job。

预期输出

text
runner=<RUNNER_NAME> os=Linux arch=X64

<RUNNER_NAME> 取决于实际 Runner。如果 Job 一直无法进入 Step,就应到仓库或组织的 Actions Runner 管理页面检查目标 Runner 是否在线,以及标签是否与 runs-on 完全匹配。

检查并发控制是否挡住新运行

concurrency 可以限制同一并发组中的工作流或 Job。部署流水线经常用它避免多个版本同时修改同一环境,但前一个运行持续时间过长时,后续运行就可能等待。

yaml
concurrency:
  group: production
  cancel-in-progress: false

这是片段示例,应放在工作流顶层。其行为是同一 production 并发组不会让多个工作流运行同时占用该组;cancel-in-progress: false 表示新的运行不会主动取消正在执行的运行。

验证时查看同一仓库中是否已有使用相同 concurrency group 的运行处于进行状态。不要看到排队就立即删除 concurrency;如果它承担生产部署互斥职责,直接移除可能让两个部署同时操作生产环境。

检查 Environment 等待条件

部署 Job 还可能引用 Environment:

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production
    steps:
      - name: Deploy
        run: echo "deploying to production"

这是片段示例,需要结合完整工作流使用。如果 production 配置了部署保护规则,Job 可能需要满足相应条件后才能继续。验证时应查看该 Job 显示的等待原因,并检查仓库 Environment 配置,而不是把等待误诊为 Runner 不可用。

当 Job 最终进入 Step 后,上述示例的预期输出为:

text
deploying to production

按阻塞点修复而不是反复重跑

如果没有匹配 Runner,就修正 runs-on 标签或恢复对应 Runner;如果 Runner 离线,就先恢复 Runner 服务与连接;如果被 concurrency 阻塞,就检查占用同组的运行是否仍然有效;如果是 Environment 等待,则按仓库配置完成或调整相应保护条件。

重新运行只能验证修复,不能消除持续存在的约束。一个可靠的判断标准是:修复后 Job 应从等待状态进入 Running,并开始产生 Step 日志;若仍未进入任何 Step,就继续检查调度条件,而不是转向应用代码本身。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Job 一直排队怎么定位

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通