ineentho/git-semver-store
ineentho
Git Semver Store是一个在代码仓库外存储版本号的工具，支持查询当前版本和递增语义化版本（major/minor/patch），适用于CI系统中给Docker镜像、npm包等打版本标签。
下载次数: 0状态：社区镜像维护者：ineentho仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Git Semver Store
Git Semver Store是一个允许在代码仓库外存储版本号的工具。灵感来源于Concourse的https://github.com/concourse/semver-resource%EF%BC%8C%E4%BD%86%E5%AE%83%E4%BC%9A%E5%AD%98%E5%82%A8%E5%AE%8C%E6%95%B4%E7%9A%84%E7%89%88%E6%9C%AC%E5%8E%86%E5%8F%B2%EF%BC%8C%E4%B8%94%E4%B8%8ECI%E7%B3%BB%E7%BB%9F%E6%97%A0%E5%85%B3%E3%80%82
预期用法是在CI中运行类似以下命令：
version=$(docker run --rm -e SSH_PRIVATE_KEY ineentho/git-semver-store increment ssh://git@gitlab.henrik.ninja:10022/ineentho/versions.git git-semver-store.txt patch "$CI_COMMIT_SHA")
然后使用生成的版本号给Docker镜像、npm包或其他内容打标签。
参考文档
git-semver-store镜像包含两个命令：check用于获取当前版本，increment用于递增语义化版本。
环境变量
为了能够拉取和推送Git仓库，必须设置SSH_PRIVATE_KEY变量，其值为具有版本仓库读写权限的完整SSH私钥。check和increment命令都需要此变量。
check命令
获取当前存储的版本：
docker run --rm ineentho/git-semver-store check 用法：check repo file repo: 版本仓库的完整SSH URL，例如：git@github.com:my/version-repo.git file: 版本文件的路径，例如：project-name.txt
increment命令
递增语义化版本的major、minor或patch部分。如果文件不存在，则初始化为0.0.0版本。
docker run --rm ineentho/git-semver-store increment 用法：increment repo file increment hash repo: 版本仓库的完整SSH URL，例如：git@github.com:my/version-repo.git file: 版本文件的路径，例如：project-name.txt increment: 要递增的语义化版本部分，有效选项为major、minor、patch hash: 要存储的Git哈希值（作为参考）
示例用法
Gitlab CI
使用该镜像有多种方式：可以直接将镜像设置为ineentho/git-semver-store，或者如果已经使用Docker-in-Docker（dind），则使用dind可能更简单。以下是使用dind为Docker镜像打版本的示例：
push: stage: push image: docker:19.03.1 only: refs: - master before_script: - docker login -u $DOCKER_USERNAME -p "$DOCKER_PASSWORD" script: - docker load -i git-semver-store.tar - version=$(docker run --rm -e SSH_PRIVATE_KEY ineentho/git-semver-store increment ssh://git@gitlab.henrik.ninja:10022/ineentho/versions.git git-semver-store.txt patch "$CI_COMMIT_SHA") - image_version="ineentho/git-semver-store:$version" - docker tag ineentho/git-semver-store $image_version - docker push $image_version
生成的版本文件git-semver-store.txt内容如下：
0.0.1 e52f7f9e713ee05e73a09c3e98020a2789139e73 0.0.2 c31d1a47621e678618a9900e0ec46eb3aa6ce91b 0.0.3 e14728e269903c0014eb784a41006da92bea5bc4
你可以查看该项目使用的版本仓库：ineentho/versions
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 git-semver-store 镜像标签
docker pull docker.xuanyuan.run/ineentho/git-semver-store:<标签>
DockerHub 原生拉取命令
docker pull ineentho/git-semver-store:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"