GitLab CI中能否通过超时取消/失败未启动的Pending Job？

GitLab CI本身没有原生内置机制，直接为未启动的Pending Job设置超时并自动取消/标记为失败。但可以通过以下几种替代方案实现类似效果：

1. GitLab API + 定时脚本 #

编写脚本定期调用GitLab API，筛选出等待时间超过阈值的Pending Job，调用API将其取消并标记为失败。

示例脚本逻辑（可根据实际环境调整）：

# 配置参数
PROJECT_ID="123"
PRIVATE_TOKEN="your_access_token"
GITLAB_URL="https://your.gitlab.instance"
TIMEOUT_THRESHOLD=3600  # 等待超时阈值（秒，示例为1小时）

# 获取所有Pending状态的Job，并过滤出超时的
curl --silent --header "PRIVATE-TOKEN: $PRIVATE_TOKEN" \
  "$GITLAB_URL/api/v4/projects/$PROJECT_ID/jobs?status=pending" | \
  jq --arg threshold "$TIMEOUT_THRESHOLD" '.[] | select((now - (.created_at | strptime("%Y-%m-%dT%H:%M:%S%z") | mktime)) > ($threshold | tonumber))' | \
  jq -r '.id' | while read JOB_ID; do
    # 取消Job
    curl --request POST --header "PRIVATE-TOKEN: $PRIVATE_TOKEN" \
      "$GITLAB_URL/api/v4/projects/$PROJECT_ID/jobs/$JOB_ID/cancel"
    # 标记为失败并添加原因
    curl --request PUT --header "PRIVATE-TOKEN: $PRIVATE_TOKEN" \
      --data "status=failed&failure_reason=Pending状态超时，已自动取消" \
      "$GITLAB_URL/api/v4/projects/$PROJECT_ID/jobs/$JOB_ID"
done

可以将这个脚本通过GitLab定时Pipeline（计划任务）定期执行，或部署在外部服务器用cron调度。

2. 优化Runner队列与资源配置 #

通过调整Runner配置减少Pending Job的等待时间，从根源降低超时需求：

• 调整Runner的concurrent参数，增加同时执行的Job数量；
• 为Runner设置request_concurrency，提升Runner从GitLab拉取Job的效率；
• 给不同优先级的Job设置Job优先级（在.gitlab-ci.yml中用priority字段），让高优先级Job优先执行；
• 增加Runner节点数量，分散负载。

3. Pipeline内前置检查Job #

在Pipeline开头添加一个专门的检查Job，通过API轮询后续Job的状态，若超过设定时间仍处于Pending状态，则触发取消操作或标记Pipeline失败。这种方案适合针对特定Pipeline的场景。

注意事项 #

• API调用需要拥有项目maintainer或owner权限的访问令牌；
• 脚本中需注意时间计算的时区一致性，避免因时区差异导致误判；
• 定时执行的频率需根据实际需求调整，避免过于频繁调用API造成资源浪费。

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