stead/bitbucket-semver

Bitbucket Semver镜像

镜像概述

本镜像封装了Bitbucket Semver工具，适用于Bitbucket Server环境，可根据仓库中合并的拉取请求自动计算下一个符合Semver规范的版本号。建议配合Semver Pull Request Checker Plugin插件使用，以强制所有拉取请求添加Semver标签。

核心功能

1. 基于合并拉取请求的前缀（Major/Minor/Patch/Upkeep）自动增量版本
2. 支持预发布标签（alpha/beta/rc及自定义预发布标签）
3. 允许添加元数据标签
4. 提供CLI和编程式两种使用方式
5. 可通过环境变量或CLI参数配置Bitbucket连接信息

使用场景

• 团队在Bitbucket Server上管理代码时，自动生成合规的版本号
• CI/CD流水线中集成，实现版本自动升级和发布
• 配合Semver插件确保拉取请求符合版本规范，减少人为错误

配置说明

环境变量

可通过以下环境变量配置连接信息：

• BITBUCKET_PROJECT_URL: Bitbucket项目仓库URL（如[***]
• BITBUCKET_USER: Bitbucket用户名
• BITBUCKET_PASSWORD: Bitbucket密码

Docker部署示例

查看帮助

bash
docker run --rm stead/bitbucket-semver --help

基本使用（通过环境变量）

bash
export BITBUCKET_PROJECT_URL="https://bitbucket.company.com/projects/foo/repos/bar"
export BITBUCKET_USER="your-username"
export BITBUCKET_PASSWORD="your-password"
docker run --rm -e BITBUCKET_PROJECT_URL -e BITBUCKET_USER -e BITBUCKET_PASSWORD stead/bitbucket-semver

带预发布标签的使用

bash
docker run --rm -e BITBUCKET_PROJECT_URL -e BITBUCKET_USER -e BITBUCKET_PASSWORD stead/bitbucket-semver --beta

带元数据的使用

bash
docker run --rm -e BITBUCKET_PROJECT_URL -e BITBUCKET_USER -e BITBUCKET_PASSWORD stead/bitbucket-semver --meta build-20240501