alpine/semver

alpine/semver Docker镜像文档

1. 镜像概述和主要用途

alpine/semver是一个基于Docker的语义化版本控制工具，实现了https://semver.org/%E8%A7%84%E8%8C%83%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%89%88%E6%9C%AC%E5%8F%B7%E7%9A%84%E8%A7%A3%E6%9E%90%E3%80%81%E6%AF%94%E8%BE%83%E5%92%8C%E7%AE%A1%E7%90%86%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E8%BD%AF%E4%BB%B6%E5%BC%80%E5%8F%91%E8%BF%87%E7%A8%8B%E4%B8%AD%E7%9A%84%E7%89%88%E6%9C%AC%E6%8E%A7%E5%88%B6%E6%B5%81%E7%A8%8B%E3%80%82

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/