GitLab CI调度器如何使用递增计数器作为变量？

可以通过GitLab API实现这个递增计数器需求，核心思路是将计数器值存储在CI/CD变量中，每次任务运行时通过API读取当前值、递增后再写回变量，具体操作步骤如下：

1. 创建存储计数器的CI/CD变量 #

在项目的「Settings > CI/CD > Variables」路径下创建一个变量，比如命名为TEST_NODE_COUNTER，初始值设为13，可根据需求勾选「Protect variable」和「Mask variable」选项。

2. 在CI/CD配置中添加计数器逻辑 #

在项目的.gitlab-ci.yml文件里添加专用步骤，通过GitLab API完成变量的读取、递增与更新：

update_counter:
  stage: prepare
  script:
    # 读取当前计数器值
    - CURRENT_VALUE=$(curl --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" "https://你的GitLab实例域名/api/v4/projects/$CI_PROJECT_ID/variables/TEST_NODE_COUNTER" | jq -r '.value')
    # 计算递增后的新值
    - NEW_VALUE=$((CURRENT_VALUE + 1))
    # 将新值写回到变量中
    - curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" "https://你的GitLab实例域名/api/v4/projects/$CI_PROJECT_ID/variables/TEST_NODE_COUNTER" --form "value=$NEW_VALUE"
  only:
    - schedules # 限定仅在调度任务触发时执行此步骤

3. 配置权限与访问令牌 #

• 创建一个具备「Maintainer」权限的个人访问令牌（PAT），勾选api权限，将该令牌作为CI/CD变量GITLAB_API_TOKEN存入项目（建议勾选保护和掩码）。
• 替换配置中的GitLab实例域名：如果使用GitLab.com，则替换为https://gitlab.com；如果是私有实例，填写对应域名即可。

4. 在调度任务中使用计数器 #

更新任务调度器的配置，直接引用$TEST_NODE_COUNTER变量即可，比如将测试节点主机名设置为test-node-$TEST_NODE_COUNTER，每次调度运行时变量值会自动递增。

注意事项 #

• 若存在多个调度任务同时触发的场景，建议添加并发控制（比如利用GitLab锁机制或API请求的乐观锁逻辑），避免计数器值冲突。
• 确保CI运行器中已安装jq工具，若未安装可在script步骤中先执行安装命令，比如apt-get install jq -y（Debian/Ubuntu环境）或apk add jq（Alpine环境）。

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