alpine/semver

alpine/semver Docker镜像文档

1. 镜像概述和主要用途

alpine/semver是一个基于Docker的语义化版本控制工具，实现了https://semver.org/规范。该镜像提供了便捷的命令行工具，用于版本号的解析、比较和管理，适用于软件开发过程中的版本控制流程。

2. 核心功能和特性

• 支持语义化版本2.0.0规范的所有操作
• 可对版本号进行校验、递增（主版本、次版本、补丁版本）等操作
• 多架构镜像支持（v7.3.7+版本），包括：
  • linux/amd64
  • linux/arm/v7
  • linux/arm64/v8
  • linux/arm/v6
  • linux/ppc64le
  • linux/s390x
• 轻量级设计，基于Alpine Linux，镜像体积小
• 无需额外配置，直接通过命令行参数使用

3. 使用场景和适用范围

• 软件开发中的版本号管理
• CI/CD流程中的自动化版本控制
• 构建脚本中的版本递增和计算
• Git标签的版本管理
• 自动化发布流程中的版本生成

4. 使用方法和配置说明

4.1 基本使用方法

通过docker run命令直接调用semver工具：

bash
# 递增次版本号
docker run --rm docker.xuanyuan.run/alpine/semver semver -c -i minor 1.0.2

# 递增补丁版本号
docker run --rm docker.xuanyuan.run/alpine/semver semver -c -i patch 1.1.0

# 从Git标签获取当前版本并递增次版本号
docker run --rm docker.xuanyuan.run/alpine/semver semver -c -i minor $(git describe --tags --abbrev=0)

4.2 命令参数说明

semver工具主要支持以下参数：

• -c 或 --check: 检查版本号是否有效
• -i 或 --increment: 递增版本号，后跟类型(major|minor|patch)
• 版本号参数: 需要操作的基础版本号

4.3 Makefile集成示例

在Makefile中集成版本管理：

makefile
RELEASE_TYPE ?= patch

CURRENT_VERSION := $(shell git ls-remote --tags | awk '{ print $2}'| sort -nr | head -n1|sed 's/refs\/tags\///g')

ifndef CURRENT_VERSION
  CURRENT_VERSION := 0.0.0
endif

NEXT_VERSION := $(shell docker run --rm alpine/semver semver -c -i $(RELEASE_TYPE) $(CURRENT_VERSION))

current-version:
	@echo $(CURRENT_VERSION)

next-version:
	@echo $(NEXT_VERSION)

release:
	git checkout master;
	git tag $(NEXT_VERSION)
	git push --tags

使用方法:

bash
# 查看当前版本
make current-version

# 查看下一个版本
make next-version

# 执行发布（默认递增补丁版本）
make release

# 递增主版本并发布
make release RELEASE_TYPE=major

5. 多架构镜像说明

5.1 架构支持情况

自2022年4月21日起，v7.3.7+版本开始支持多架构镜像，包括：

• linux/amd64
• linux/arm/v7
• linux/arm64/v8
• linux/arm/v6
• linux/ppc64le
• linux/s390x

5.2 使用方法

多架构镜像使用方式与普通镜像一致，无需额外配置：

bash
# 拉取镜像（会自动匹配当前架构）
docker pull docker.xuanyuan.run/alpine/semver

# 运行镜像（自动使用适合当前架构的镜像）
docker run --rm docker.xuanyuan.run/alpine/semver semver -c 1.0.0

对于ARM架构设备（如Mac M1芯片），直接使用标准命令即可获取对应架构的镜像。

6. 相关资源

• GitHub仓库: https://github.com/alpine-docker/multi-arch-libs/blob/master/semver/Dockerfile
• Docker Hub镜像: https://hub.docker.com/r/alpine/semver/tags/