mrooding/gitlab-semantic-versioning

gitlab-semantic-versioning

Docker镜像，用于GitLab项目中自动实现语义化版本控制，基于Git标签和合并请求标签确定版本更新类型。更多语义化版本信息可参考semver.org。

核心功能

1. 基于Git标签维护项目版本，无标签时首次更新生成1.0.0版本
2. 根据合并请求标签自动决定更新类型：
   • 含bump-major标签：主版本更新
   • 含bump-minor标签：次版本更新
   • 无标签：默认补丁更新
3. 支持通过环境变量MINOR_BUMP_LABEL和MAJOR_BUMP_LABEL自定义更新标签

使用场景

适用于GitLab项目的CI/CD流水线，自动生成和更新语义化版本号，规范版本管理流程，提升开发效率。

配置说明

先决条件

组标签

• 需确保项目组存在bump-minor和bump-major标签（全局标签不自动同步至现有组，需手动添加）
• 可通过环境变量自定义标签名称

API Token与组

• 创建仅有权限访问项目组的虚拟用户（如${group_name}_npa）
• 生成该用户的API scope个人访问令牌

组级变量

在组的Settings->CI/CD中添加变量：

流水线配置示例

stages:
  - generate-env-vars
  - version
  - tag-latest

variables:
  IMAGE_NAME: $CI_REGISTRY/$CI_PROJECT_NAMESPACE/$CI_PROJECT_NAME

generate-env-vars:
  stage: generate-env-vars
  script:
    - TAG=$(git describe --tags --always)
    - echo "export TAG=$TAG" > .variables
    - echo "export IMAGE=$IMAGE_NAME:$TAG" >> .variables
    - cat .variables
  artifacts:
    paths:
    - .variables

version:
  stage: version
  image: mrooding/gitlab-semantic-versioning:1.0.0
  script:
    - python3 /version-update/version-update.py
  only:
   - master

tag-latest:
  stage: tag-latest
  image: docker:18.06.1-ce
  before_script:
    - source .variables
  script:
    - docker pull $IMAGE
    - docker tag $IMAGE $IMAGE_NAME:latest
    - docker push $IMAGE_NAME:latest
  only:
    - tag

合并请求说明

1. 合并时需勾选“Squash commits when merge request is accepted”（依赖该格式提取合并请求ID）
2. 根据更新类型添加对应标签（bump-minor/bump-major），无标签则默认补丁更新