GitLab CI定时流水线连续失败通知及变量操作相关问题咨询

1. 实现仅流水线连续构建失败N次后发送通知 #

核心思路是通过持久化存储连续失败的计数，每次流水线结束后更新计数，达到阈值时触发通知，实现步骤如下：

• 首先在项目「设置」-「CI/CD」-「变量」中创建可写项目变量CONSECUTIVE_FAILURE_COUNT，初始值设为0，关闭「受保护」「屏蔽」选项，确保流水线有权限修改该变量值。
• 提前创建一个拥有项目变量编辑权限的个人访问令牌，存储为项目CI/CD变量GITLAB_ACCESS_TOKEN。
• 在.gitlab-ci.yml中新增通知阶段，分别配置失败更新计数、触发通知，和成功重置计数的任务，示例配置如下：

stages:
  # 你的原有业务阶段，例如build、test、deploy
  - notify

# 流水线失败时执行的任务：更新连续失败计数+判断是否触发通知
count_fail_and_notify:
  stage: notify
  image: curlimages/curl:latest
  when: on_failure
  script:
    - NEW_COUNT=$((CONSECUTIVE_FAILURE_COUNT + 1))
    # 调用GitLab API更新项目变量中的连续失败计数
    - |
      curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_ACCESS_TOKEN" \
      "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/variables/CONSECUTIVE_FAILURE_COUNT" \
      --form "value=${NEW_COUNT}"
    # 连续失败5次触发通知，阈值可自行调整
    - if [ ${NEW_COUNT} -ge 5 ]; then
        # 此处替换为你的邮件发送逻辑，例如调用邮件服务API、使用mailx指令发送等
        echo "流水线已连续失败${NEW_COUNT}次，触发通知";
      fi

# 流水线成功时执行的任务：重置连续失败计数
reset_fail_count:
  stage: notify
  image: curlimages/curl:latest
  when: on_success
  script:
    - |
      curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_ACCESS_TOKEN" \
      "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/variables/CONSECUTIVE_FAILURE_COUNT" \
      --form "value=0"

2. .gitlab-ci.yml 中对定时流水线变量的操作说明 #

针对定时变量的设置、取消、自增操作，可按场景实现：

• 单次流水线运行时的临时修改：直接在job的script中通过export 变量名=新值即可修改，修改后的值仅在当前job的后续步骤生效，不会影响其他job或后续的流水线运行，自增操作可直接用export MY_VAR=$((MY_VAR + 1))实现。
• 需修改后的值对后续所有流水线（含后续定时流水线）生效：无法直接通过yml静态配置修改定时流水线的预设变量，可通过调用GitLab项目变量API的方式更新对应变量值，示例逻辑和上述更新连续失败计数的API调用逻辑一致，取消变量可通过API删除对应变量，或设置值为空即可。

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