alpine/semver Docker Image
自动构建
用于语义化版本控制的Docker工具
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中集成版本管理:
makefileRELEASE_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/
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/semver:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务