Bitbucket Pipelines构建带版本Docker镜像的最优方案咨询

针对你在Bitbucket Pipelines中部署Spring Boot应用时遇到的Docker版本管理需求，我推荐用仓库版本文件+流水线脚本逻辑的组合方案，既能严格遵循你的版本规则（alpha_0.1、beta_1.0这类格式），又能自动化完成版本升级、镜像构建和版本记录更新。下面是具体实现步骤和配置：

核心思路 #

我们会用项目根目录的VERSION文件存储当前版本（比如alpha_0.1），在流水线中读取并解析这个版本号，根据更新类型（小更新/重大更新）生成新版本，再用这个版本号构建Docker镜像，最后更新VERSION文件并提交回仓库，作为下一次构建的基准。

步骤1：初始化版本文件 #

在你的Spring Boot项目根目录创建一个VERSION文件，写入初始版本（比如alpha_0.1），然后提交到Git仓库：

echo "alpha_0.1" > VERSION
git add VERSION
git commit -m "Initial version"
git push origin master

步骤2：修改流水线配置（适配版本升级逻辑） #

下面是修改后的完整bitbucket-pipelines.yml，我加入了版本解析、升级逻辑，同时保证Spring Boot应用版本和Docker镜像版本一致：

image: java:8
options:
  docker: true
branches:
  master:
    - step:
        caches:
          - gradle
        script:
          # 1. 读取并解析当前版本
          - CURRENT_VERSION=$(cat VERSION)
          - STAGE=$(echo $CURRENT_VERSION | cut -d'_' -f1)
          - MAJOR=$(echo $CURRENT_VERSION | cut -d'_' -f2 | cut -d'.' -f1)
          - MINOR=$(echo $CURRENT_VERSION | cut -d'_' -f2 | cut -d'.' -f2)
          
          # 2. 判断更新类型：提交信息含[major]则触发重大更新，否则小更新
          - |
              if [[ "$BITBUCKET_COMMIT_MESSAGE" == *"[major]"* ]]; then
                  # 按alpha→beta→gamma顺序切换版本阶段，可根据你的规则调整
                  case $STAGE in
                      alpha) NEW_STAGE="beta";;
                      beta) NEW_STAGE="gamma";;
                      gamma) NEW_STAGE="gamma";; # gamma阶段后仅升级主版本号
                  esac
                  NEW_MAJOR=$((MAJOR + 1))
                  NEW_MINOR=0
              else
                  # 小更新：仅升级次要版本号
                  NEW_STAGE=$STAGE
                  NEW_MAJOR=$MAJOR
                  NEW_MINOR=$((MINOR + 1))
              fi
          - NEW_VERSION="${NEW_STAGE}_${NEW_MAJOR}.${NEW_MINOR}"
          
          # 3. 将新版本号注入Spring Boot应用（Gradle示例，Maven同理修改pom.xml）
          - echo "version = '$NEW_VERSION'" > gradle.properties
          
          # 4. 测试、构建应用
          - ./gradlew test
          - ./gradlew build -x test # 跳过重复测试，加快构建速度
          
          # 5. Docker构建与推送（替换为你的镜像仓库地址）
          - docker login -u $DOCKER_USER -p $DOCKER_PASSWORD <your-registry-url> # 私有仓库需登录
          - docker build -t <your-registry-url>/<application-name>:${NEW_VERSION} .
          - docker push <your-registry-url>/<application-name>:${NEW_VERSION}
          
          # 6. 更新版本文件并提交回仓库
          - git config user.name "Bitbucket Pipelines"
          - git config user.email "pipelines@bitbucket.org"
          - echo $NEW_VERSION > VERSION
          - git add VERSION gradle.properties
          - git commit -m "Bump version to ${NEW_VERSION}"
          - git push origin master
        services:
          - docker

关键细节说明 #

版本升级触发方式 #

• 小更新/BUG修复：直接提交代码到master分支，提交信息不需要特殊标记，流水线会自动将次要版本号+0.1（比如alpha_0.1→alpha_0.2）。
• 重大更新：提交代码时在提交信息中加入[major]标记（比如feat: 完成核心功能重构 [major]），流水线会自动切换版本阶段（alpha→beta→gamma）并将主版本号+1.0，次要版本号重置为0（比如alpha_0.2→beta_1.0）。

权限配置 #

• Git推送权限：需要在Bitbucket仓库的「Settings > Pipelines > Repository settings」中勾选「Allow pipelines to access Git repositories」，确保流水线能推送修改后的VERSION文件回仓库。
• Docker仓库权限：在Bitbucket仓库的「Settings > Repository variables」中添加DOCKER_USER和DOCKER_PASSWORD变量，用于登录私有镜像仓库。

更灵活的手动触发方案（可选） #

如果不想依赖提交信息标记，也可以用Bitbucket的自定义管道，创建两个手动触发的管道分别处理小更新和重大更新，避免误触发：

pipelines:
  custom:
    bump-minor: # 手动触发小版本升级
      - step:
          script:
            - CURRENT_VERSION=$(cat VERSION)
            - STAGE=$(echo $CURRENT_VERSION | cut -d'_' -f1)
            - MAJOR=$(echo $CURRENT_VERSION | cut -d'_' -f2 | cut -d'.' -f1)
            - MINOR=$(echo $CURRENT_VERSION | cut -d'_' -f2 | cut -d'.' -f2)
            - NEW_VERSION="${STAGE}_${MAJOR}.$((MINOR + 1))"
            # 后续步骤同master分支的脚本...
    bump-major: # 手动触发重大版本升级
      - step:
          script:
            - CURRENT_VERSION=$(cat VERSION)
            - STAGE=$(echo $CURRENT_VERSION | cut -d'_' -f1)
            - MAJOR=$(echo $CURRENT_VERSION | cut -d'_' -f2 | cut -d'.' -f1)
            - case $STAGE in alpha) NEW_STAGE="beta";; beta) NEW_STAGE="gamma";; gamma) NEW_STAGE="gamma";; esac
            - NEW_VERSION="${NEW_STAGE}_$((MAJOR + 1)).0"
            # 后续步骤同master分支的脚本...

你可以在Bitbucket的「Pipelines」页面手动选择运行bump-minor或bump-major管道，完全掌控版本升级时机。

为什么这是最优方案？ #

1. 版本透明化：用VERSION文件存储版本，团队成员可以直接查看当前版本，Git历史也能追溯所有版本变更记录。
2. 自动化程度高：无需手动修改版本号，流水线会根据规则自动生成并更新版本。
3. 版本一致性：Spring Boot应用的版本和Docker镜像版本完全一致，避免版本混乱。
4. 灵活可扩展：可以轻松调整版本阶段规则（比如新增delta阶段），或者修改版本号升级逻辑。

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