Gitlab CI中Master分支版本更新后部署作业获取对应版本的问题

核心原因 #

GitLab CI流水线默认基于触发流水线的初始commit创建代码快照，Versioning作业提交的新commit不会自动同步到后续Deployment作业的工作目录，因此Deployment读取到的仍是旧版本的pyproject.toml。

可行解决方案 #

方案一：通过CI变量传递新版本号（推荐） #

直接在Versioning作业中把计算好的新版本号传递给Deployment作业，无需依赖仓库文件：

1. Versioning作业中计算新版本后，将版本号写入环境变量文件：

   # 假设已算出新版本号并存入NEW_VERSION变量
   echo "NEW_VERSION=$NEW_VERSION" >> version.env
   

2. 在Versioning作业的CI配置中添加 artifacts 配置，传递环境变量：

   versioning_job:
     script:
       # 你的版本计算、更新pyproject.toml、提交代码逻辑
       - echo "NEW_VERSION=$NEW_VERSION" >> version.env
     artifacts:
       reports:
         dotenv: version.env
   

3. Deployment作业直接使用$NEW_VERSION变量，无需读取pyproject.toml：

   deployment_job:
     needs: [versioning_job]
     script:
       # 使用$NEW_VERSION进行部署操作
       - echo "部署版本: $NEW_VERSION"
   

• 优势：重启Deployment作业时，变量值是当前流水线生成的固定版本号，不会拿到master分支的最新版本；逻辑简单，无需修改仓库读取逻辑。

方案二：传递Versioning提交的新Commit SHA，直接Checkout该版本 #

如果Deployment需要完整的项目代码（而非仅版本号），可以传递新commit的SHA：

1. Versioning作业中获取提交后的commit SHA并写入环境变量：

   # 提交代码后执行
   COMMIT_SHA=$(git rev-parse HEAD)
   echo "COMMIT_SHA=$COMMIT_SHA" >> commit.env
   

2. 同样通过dotenv artifacts传递SHA：

   versioning_job:
     script:
       # 版本更新、提交代码逻辑
       - COMMIT_SHA=$(git rev-parse HEAD)
       - echo "COMMIT_SHA=$COMMIT_SHA" >> commit.env
     artifacts:
       reports:
         dotenv: commit.env
   

3. Deployment作业中切换到该commit：

   deployment_job:
     needs: [versioning_job]
     script:
       - git checkout $COMMIT_SHA
       # 读取pyproject.toml或执行部署
       - cat pyproject.toml | grep version
   

• 优势：能拿到包含新版本的完整代码，重启作业时仍使用固定的commit SHA，不会随master分支更新而变化。

方案三：优化重新克隆逻辑（不推荐） #

若一定要通过克隆仓库获取新版本，可在Deployment作业中添加判断逻辑，避免重复克隆：

deployment_job:
  needs: [versioning_job]
  script:
    # 假设通过方案一传递了NEW_VERSION变量
    - CURRENT_VERSION=$(cat pyproject.toml | grep version | cut -d'"' -f2)
    - if [ "$CURRENT_VERSION" != "$NEW_VERSION" ]; then
        git fetch origin master;
        git checkout origin/master;
      fi
    # 执行部署

• 劣势：依赖网络和Git权限，逻辑相对复杂，不如前两个方案可靠。

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