semver

alpine/semver Docker Image

自动构建

用于语义化版本控制的Docker工具

4 次收藏下载次数: 0状态:自动构建维护者:Alpine 工具与轻量镜像仓库类型:镜像最近更新:

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/

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 semver 镜像标签

docker pull docker.xuanyuan.run/alpine/semver:<标签>

DockerHub 原生拉取命令

docker pull alpine/semver:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告