GitLab版本化流水线配置疑问：版本文件推送时机与方式

核心问题分析 #

你当前的代码仅推送了版本标签，未将更新version.py的提交推送到main分支；且直接推送会触发新流水线导致无限循环，这两个点是核心待解决问题。

解决方案步骤 #

1. 修改Python版本化代码 #

补充推送版本文件提交到main分支的逻辑，同时在提交信息中加入[skip ci]标记跳过流水线触发，还要配置CI环境下的git推送权限：

import os

def update_version_in_file(file_path, version):
    if not os.path.exists(file_path):
        logger.warning(f"Unable to write version to file. File path '{file_path}' does not exist")
        return

    logger.info(f"Updating version in file to: {version}")
    with open(file_path,"r+", encoding="utf-8") as v:
        tree = ast.parse(v.read())
        updater = VersionUpdater(version)
        tree = updater.visit(tree)
        v.seek(0)
        v.write(astor.to_source(tree))
        v.truncate()  # 截断文件末尾残留的旧内容
    
    git("add",file_path)
    # 加入[skip ci]标记，避免触发新流水线
    git("commit","-m",f"File version update {version} [skip ci]")

def main():
    version = func_to_get_version()
    git("config","http.sslCAInfo",CERTIFICATE_PATH)
    git("config","user.email","<your-ci-email>")
    git("config","user.name","<your-ci-username>")

    # 配置GitLab CI推送权限，使用内置CI_JOB_TOKEN
    repo_url = os.environ['CI_PROJECT_URL'].replace('https://', '')
    git("remote", "set-url", "origin", f"https://gitlab-ci-token:{os.environ['CI_JOB_TOKEN']}@{repo_url}.git")

    version_file_path = os.environ.get("VERSION_FILE_PATH","./app/version.py")

    update_version_in_file(version_file_path,version)
    tag_repo(version)
    
    # 先推送版本标签
    git("push", "origin", version)
    # 再推送更新版本文件的提交到main分支
    git("push", "origin", "HEAD:main")

    return 0

2. 修改流水线配置 #

添加规则排除带有[skip ci]的提交，彻底避免无限循环：

version-job:
  stage: version
  variables:
    VERSION_FILE_PATH: "<path-to-version-file>"
  image: <custom-image>
  script:
    - python3 /version_app/main.py
  rules:
    # 仅在main分支、且提交信息不含[skip ci]时触发
    - if: '$CI_COMMIT_BRANCH == "main" && $CI_COMMIT_MESSAGE !~ /\[skip ci\]/'
  tags:
    - <runner-tag>

3. 关键权限配置 #

确保GitLab runner具备推送代码到main分支的权限：

• 进入项目设置→仓库→受保护分支，找到main分支并勾选「允许CI/CD推送」
• 无需额外配置令牌，默认的CI_JOB_TOKEN已具备项目写入权限

注意事项 #

• v.truncate()必须添加：更新文件后截断多余内容，防止旧代码残留
• [skip ci]是GitLab官方支持的流水线跳过关键字，需严格按格式书写
• 推送顺序不可颠倒：先推标签再推提交，确保标签关联到最新的版本文件变更

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