relizaio/versioning

Reliza Versioning 镜像文档

镜像概述

Reliza Versioning是一款由Reliza开发的版本自动递增工具，旨在帮助软件项目实现版本号的自动化管理。该工具能够根据预设规则或自定义配置，自动递增软件版本号（如主版本、次版本、修订号等），并可与版本控制系统（如Git）及CI/CD流程集成，简化版本管理流程，提升开发效率。

核心功能与特性

• 自动版本递增：支持主版本（major）、次版本（minor）、修订号（patch）等多类型版本号递增
• 版本控制集成：可与Git等版本控制系统联动，基于提交记录、标签等信息生成或更新版本号
• 自定义版本格式：允许用户定义版本号格式，适配不同项目的版本命名规范
• 灵活配置：支持通过配置文件或环境变量自定义递增规则及行为
• 轻量级部署：以Docker镜像形式提供，易于集成到各类开发环境和CI/CD管道

使用场景

• 软件开发流程：本地开发或团队协作中自动化版本管理，减少手动操作误差
• CI/CD流程集成：在持续集成/部署流程中自动更新版本号并生成发布标签
• 多项目版本统一：统一管理多关联项目的版本号，确保版本一致性
• 开源项目管理：辅助遵循语义化版本规范（SemVer），提升版本管理透明度

使用方法与配置说明

基本使用（Docker Run）

通过以下命令运行容器实现版本号自动递增：

bash
docker run -v $(pwd):/app relizaio/versioning:latest \
  -f /app/version.txt \
  -t patch

参数说明：

• -v $(pwd):/app：挂载当前目录至容器内/app目录，便于工具访问版本文件
• -f /app/version.txt：指定版本文件路径，工具将读取并更新该文件中的版本号
• -t patch：设置版本递增类型，可选值包括major（主版本）、minor（次版本）、patch（修订号）

环境变量配置

支持通过环境变量自定义工具行为，常用变量如下：

Docker Compose配置示例

yaml
version: '3'
services:
  versioning:
    image: relizaio/versioning:latest
    volumes:
      - ./:/app  # 挂载当前目录至容器内/app
    environment:
      - VERSION_FILE=/app/version.txt  # 版本文件路径
      - INCREMENT_TYPE=minor  # 递增次版本号
      - VERSION_FORMAT={major}.{minor}.{patch}-beta  # 自定义版本格式

更多信息

完整配置选项、高级用法及示例，请参考项目GitHub页面：https://github.com/relizaio/versioning