如何排查GitLab CI定时流水线未运行的问题？

以下是针对定时流水线不触发、手动触发无反馈无错误的排查步骤：

• 核对定时任务基础配置

  • 确认时区设置：进入定时任务详情页，检查时区是否符合预期（GitLab默认用UTC，可能和本地时间差导致任务未到触发点）。
  • 确认激活状态：确保任务勾选了「Active」，避免被误禁用。
  • 检查目标分支/标签：确认设置的分支未被删除、重命名；若为标签，需确保标签真实存在且匹配规则。

• 验证CI配置文件有效性

  • 先手动触发一次分支流水线：如果这个也无法正常运行，说明问题出在.gitlab-ci.yml本身。
    • 用CI Lint工具校验语法：在项目「CI/CD」→「CI Lint」中粘贴配置文件，排查语法错误。
    • 检查job触发规则：定时任务的CI_PIPELINE_SOURCE为schedule，需确保job的rules/only/except配置允许该来源，示例：

      rules:
        - if: '$CI_PIPELINE_SOURCE == "schedule"'
          when: always
      

    • 排查依赖job限制：若前置job因规则不满足未触发，可能导致整个流水线无反馈，但通常流水线会被创建，需确认job间的依赖逻辑。

• 检查权限相关配置

  • 确认任务创建者权限：若创建者账号被禁用、权限降级（如从维护者变为开发者），任务可能无法触发。尝试用维护者以上权限账号创建测试任务。
  • 确认项目CI/CD功能状态：在项目「设置」→「通用」→「Visibility, project features, permissions」中，确保CI/CD功能未被禁用。

• 排查实例级限制（自托管/SAAS）

  • 流水线配额检查：查看项目「设置」→「CI/CD」→「流水线配额」，确认是否已用完配额导致无法创建新流水线。
  • Sidekiq队列检查（自托管）：执行命令gitlab-rake sidekiq:queue:status查看后台任务队列是否有堆积或失败，定时任务由Sidekiq调度，队列异常会导致触发失败。

• 通过日志定位问题

  • 自托管环境：查看/var/log/gitlab/gitlab-rails/production.log或/var/log/gitlab/sidekiq/current日志，搜索pipeline_schedule关键词，提取错误信息。
  • SAAS环境：联系GitLab官方支持，提供项目ID和定时任务ID，请求协助查看后台日志。

• 其他应急排查动作

  • 重建定时任务：删除现有任务，创建仅包含echo "test"的简单测试任务，验证是否能正常触发。
  • 检查GitLab版本：自托管用户确认是否存在已知版本bug，必要时升级至最新稳定版。

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