mwader/bump

mwader

一个通用的版本跟踪和更新工具，用于自动化管理Makefile、Dockerfile、脚本等文本文件中的依赖版本，支持通过配置文件定义版本检测规则和更新策略。

下载次数: 0状态：社区镜像维护者：mwader仓库类型：镜像最近更新：1 个月前

让 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 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Bump

一个通用的版本跟踪和更新工具。

Bump可用于自动化版本更新，适用于其他版本和包管理系统不适用或无法使用的场景。例如，当需要在Makefile、Dockerfile、脚本或其他文本文件中管理依赖版本时。

以下是一个Bumpfile示例，用于将Dockerfile基础镜像版本自动更新到最新的Alpine 3版本：

sh
$ cat Bumpfile
alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
alpine link "发布说明" https://alpinelinux.org/posts/Alpine-$LATEST-released.html
Dockerfile
# 查看当前版本
$ bump current
Dockerfile:1: alpine 3.9.2
# 检查可用更新
$ bump check
alpine 3.13.0
# 查看更新差异
$ bump diff
--- Dockerfile
+++ Dockerfile
@@ -1,2 +1,2 @@
-FROM alpine:3.9.2 AS builder
+FROM alpine:3.13.0 AS builder
 
# 应用更新
$ bump update

实际应用示例可参考https://github.com/wader/static-ffmpeg/blob/master/Dockerfile%EF%BC%8C%E5%85%B6%E4%B8%AD%E9%87%8D%E8%A6%81%E5%BA%93%E9%80%9A%E8%BF%87bump GitHub Action实现自动更新。

GitHub Action

Bump可作为GitHub Action使用，直接使用wader/bump/action@master或https://help.github.com/en/actions/automating-your-workflow-with-github-actions/configuring-a-workflow#referencing-actions-in-your-workflow%E3%80%82%E4%BB%A5%E4%B8%8B%E6%98%AF%E6%AF%8F%E5%A4%A99%E7%82%B9%EF%BC%88UTC%EF%BC%89%E8%AF%BB%E5%8F%96Bumpfile%E6%A3%80%E6%9F%A5%E7%89%88%E6%9C%AC%E6%9B%B4%E6%96%B0%E5%B9%B6%E5%88%9B%E5%BB%BAPR%E7%9A%84%E5%B7%A5%E4%BD%9C%E6%B5%81%E9%85%8D%E7%BD%AE%EF%BC%9A

yml
name: '自动版本更新'
on:
  schedule:
    # 分 时 日 月 周 (UTC)
    - cron: '0 9 * * *'
  # 允许手动触发版本更新
  workflow_dispatch:
jobs:
  bump:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
      - uses: wader/bump/action@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

查看action.yml获取输入参数详情。

注意：若希望bump创建的PR触发其他Action（如CI构建），https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows#about-workflow-events%EF%BC%8C%E5%B9%B6%E6%B7%BB%E5%8A%A0%E4%B8%BA%E5%AF%86%E9%92%A5%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%E6%B7%BB%E5%8A%A0%E5%90%8D%E4%B8%BA%60BUMP_TOKEN%60%E7%9A%84%E5%AF%86%E9%92%A5%EF%BC%8C%E7%84%B6%E5%90%8E%E9%85%8D%E7%BD%AE%60GITHUB_TOKEN: ${{ secrets.BUMP_TOKEN }}`。

提供以下不同环境的Action：
wader/bump/action@master：包含git和curl的alpine环境
wader/bump/action/go@master：包含git、curl和go的alpine环境

安装

Docker

Docker Hub镜像：

sh
docker run --rm -v "$PWD:$PWD" -w "$PWD" mwader/bump help

构建镜像：

sh
docker build -t bump .

源码构建

安装go后执行以下命令，可将bump安装到$(go env GOPATH)/bin/bump：

sh
go get github.com/wader/bump/cmd/bump

使用

sh
$ bump help
用法: bump [选项] 命令
选项:
  -e                    要排除的配置名称（逗号分隔）
  -f                    要读取的Bumpfile（默认：Bumpfile）
  -i                    要包含的配置名称（逗号分隔）
  -r                    运行更新命令（默认：false）
  -v                    详细输出（默认：false）

命令:
  version               显示bump自身版本（dev）
  help [FILTER]         显示帮助或指定过滤器的帮助
  list [FILE...]        显示bump配置
  current [FILE...]     显示当前版本
  check [FILE...]       检查可能的版本更新
  update [FILE...]      更新版本
  diff [FILE...]        显示更新将产生的差异
  pipeline PIPELINE     运行过滤器管道

BUMPFILE是包含CONFIG或文件全局模式的文件
FILE是包含EMBEDCONFIG或待检查更新版本的文件
EMBEDCONFIG格式："bump: CONFIG"
CONFIG格式:
  名称 /正则表达式/ 管道 |
  名称 command 命令 |
  名称 after 命令 |
  名称 message 消息 |
  名称 link 标题 URL
名称是配置的标识
正则表达式是包含一个子匹配以查找当前版本的正则
管道是过滤器管道：过滤器|过滤器|...
过滤器:
  git:<仓库> | <仓库.git>
  gitrefs:<仓库>
  docker:<镜像>
  svn:<仓库>
  fetch:<URL> | <http://> | <https://>
  semver:<约束> | semver:<n.n.n-pre+build> | <约束> | <n.n.n-pre+build>
  re:/<正则表达式>/ | re:/<正则表达式>/<模板>/ | /<正则表达式>/ | /<正则表达式>/<模板>/
  sort
  key:<名称> | @<名称>
  static:<名称[:键=值:...]>,...
  err:<错误>

配置

名称是配置的标识。

正则表达式是golang正则表达式，包含一个子匹配用于查找当前版本。

管道是描述如何查找最新合适版本的过滤器管道：过滤器|过滤器|...

Bumpfile

默认情况下，bump在当前目录查找名为Bumpfile的文件。每行可为注释、配置或文件全局模式（用于读取嵌入式配置）。

# 注释
名称 /正则表达式/ 管道
名称 [command|after] 命令
名称 message 消息
名称 link 标题 URL
文件名
全局模式/*

Bumpfile示例：

# 一个bump配置
alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
alpine message 确保同时使用abc进行测试
alpine link "发布说明" https://alpinelinux.org/posts/Alpine-$LATEST-released.html
# 读取配置，检查并更新Dockerfile中的版本
Dockerfile

嵌入式配置

嵌入式配置可将bump配置直接包含在需要检查或更新版本的文件中。

嵌入式配置格式：

bump: 名称 /正则表达式/ 管道

含嵌入式配置的Dockerfile示例：

# bump: alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
FROM alpine:3.9.3 AS builder

更新时运行shell命令

bump: 名称 [command|after] 命令

执行命令时会设置以下环境变量：
$名称：配置名称
$CURRENT：当前版本
$LATEST：可用的最新版本

有两种shell命令类型：command和after。command会替代bump的默认修改操作；after会在bump完成修改后执行。若配置多个命令，将按配置顺序执行。

使用command通过go get更新go.mod和go.sum的Bumpfile示例：

module program

go 1.12

require (
  // bump: leaktest /github.com\/fortytw2\/leaktest v(.*)/ git:https://github.com/fortytw2/leaktest.git|^1
  // bump: leaktest command go get -d github.com/fortytw2/leaktest@v$LATEST && go mod tidy
  github.com/fortytw2/leaktest v1.2.0
)

使用after运行脚本更新下载哈希的Bumpfile示例：

libvorbis after ./hashupdate Dockerfile VORBIS $LATEST

提交和拉取请求消息及链接

名称 message 消息
名称 link "标题" URL

消息、标题和URL中可使用以下变量：
$名称：配置名称
$CURRENT：当前版本
$LATEST：可用的最新版本

通过配置一个或多个message和link，可将消息和链接包含在提交消息和拉取请求中。

示例：

libvorbis link "CHANGES文件" https://github.com/xiph/vorbis/blob/master/CHANGES
libvorbis link "源码差异 $CURRENT..$LATEST" https://github.com/xiph/vorbis/compare/v$CURRENT..v$LATEST

管道

管道由一个或多个按顺序执行的过滤器组成。通常以从某个源（如git仓库）生成版本的过滤器开始，后续过滤器用于选择、转换和排序版本，最终确定一个版本。若管道生成多个版本，将使用第一个。

版本是键值对字典，"name"键通常是版本号（如"1.2.3"）或符号名称（如"master"）。版本还可包含其他键（如"commit"、"version"等），具体取决于源。可使用键过滤器key:<名称>或@<名称>引用这些键。

默认所有过滤器操作默认键"name"，可通过key:<名称>或@<名称>在管道中更改默认键。

示例

以下示例使用bump pipeline 管道测试运行管道并显示结果。使用bump -v pipeline 管道可获取更详细的输出，有助于测试管道。

sh
# 最新的4.0版本ffmpeg
$ bump pipeline 'https://github.com/FFmpeg/FFmpeg.git|^4'
4.3.1
# 最新4.0版本ffmpeg的提交哈希
$ bump pipeline 'https://github.com/FFmpeg/FFmpeg.git|^4|@commit'
a3a26a98652fbdaa474e95cfbc12f68b64ca1e6f
# 最新的1.0版本golang docker构建镜像
$ bump pipeline 'docker:golang|^1'
1.15.6
# 最新的mp3lame版本
$ bump pipeline 'svn:http://svn.code.sf.net/p/lame/svn|/^RELEASE__(.*)$/|/_/./|*'
3.100

过滤器

过滤器用于生成、转换和筛选版本。部分过滤器（如git）生成版本，re和semver用于转换和筛选。

git git:<仓库> 或 <仓库.git>
gitrefs gitrefs:<仓库>
docker docker:<镜像>
svn svn:<仓库>
fetch fetch:<URL>、<http://> 或 <https://>
semver semver:<约束>、semver:<n.n.n-pre+build>、<约束> 或 <n.n.n-pre+build>
re re:/<正则表达式>/、re:/<正则表达式>/<模板>/、/<正则表达式>/ 或 /<正则表达式>/<模板>/
sort sort
key key:<名称> 或 @<名称>
static static:<名称[:键=值:...]>,...
err err:<错误>

git

git:<仓库> 或 <仓库.git>

从git仓库的标签生成版本。"name"为标签中的版本号，"commit"为提交哈希或标签对象。

使用gitrefs过滤器可从所有引用生成版本。

sh
$ bump pipeline 'https://github.com/git/git.git|*'
2.30.0
$ bump pipeline 'git://github.com/git/git.git|*'
2.30.0

gitrefs

gitrefs:<仓库>

从git仓库的所有引用生成版本。"name"为完整引用（如"refs/tags/v2.7.3"），"commit"为提交哈希。

使用git过滤器仅从标签生成版本。

sh
$ bump pipeline 'gitrefs:https://github.com/git/git.git'
HEAD

docker

docker:<镜像>

从Docker Hub镜像生成版本。

sh
$ bump pipeline 'docker:alpine|^3'
3.13.0

svn

svn:<仓库>

从subversion仓库的标签和分支生成版本。"name"为标签或分支名称，"version"为修订号。

sh
$ bump pipeline 'svn:https://svn.apache.org/repos/asf/subversion|*'
1.14.0

fetch

fetch:<URL>、<http://> 或 <https://>

获取URL内容，生成一个版本，"name"键为内容。

sh
$ bump pipeline 'fetch:http://libjpeg.sourceforge.net|/latest release is version (\w+)/'
6b

semver

semver:<约束>、semver:<n.n.n-pre+build>、<约束> 或 <n.n.n-pre+build>

使用语义化版本筛选或转换版本。

提供约束时，用于查找满足约束的最新版本。

提供版本模式时，用于转换版本。

sh
# 查找最新的主版本1版本
$ bump pipeline 'static:1.1.2,1.1.3,1.2.0|semver:^1'
1.2.0
# 查找最新的次版本1.1版本
$ bump pipeline 'static:1.1.2,1.1.3,1.2.0|~1.1'
1.1.3
# 转换为仅主版本.次版本
$ bump pipeline 'static:1.2.3|n.n'
1.2

re

re:/<正则表达式>/、re:/<正则表达式>/<模板>/、/<正则表达式>/ 或 /<正则表达式>/<模板>/

可通过将第一个/替换为其他字符指定替代的正则/模板分隔符，例如：re:#正则表达式#模板#。

使用golang正则表达式筛选名称。若名称不匹配正则表达式，版本将被跳过。

若仅提供正则表达式且无模板和子匹配，名称不变。

若定义子匹配，名为"name"或"value"的子匹配将分别用作名称和值，否则第一个子匹配用作名称。

若定义模板且无匹配子，模板用作替换字符串；若有子匹配，模板用于展开$0、${1}、$name等。

正则表达式可多次匹配。使用^$锚点或(?m:)确保单次匹配或按行匹配。

sh
# 仅筛选
$ bump pipeline 'static:a,b|/b/'
b
# 简单替换
$ bump pipeline 'static:aaa|re:/a/b/'
bbb
# 使用#作为分隔符的简单替换
$ bump pipeline 'static:aaa|re:#a#b#'
bbb
# 第一个子匹配作为名称
$ bump pipeline 'static:ab|re:/a(.)/'
b
# 多子匹配替换
$ bump pipeline 'static:ab:1|/(.)(.)/${0}$2$1/'
abba
# 命名子匹配作为名称和值
$ bump pipeline 'static:ab|re:/(?P<name>.)(?P<value>.)/'
a
$ bump pipeline 'static:ab|re:/(?P<name>.)(?P<value>.)/|@value'
b

sort

sort

按字母逆序排序版本。

sh
$ bump pipeline 'static:a,b,c|sort'
c

key

key:<名称> 或 @<名称>

更改管道的默认键。常用于管道末尾（如使用git提交哈希而非标签名称）或管道中间（如需基于其他键进行正则筛选）。

sh
$ bump pipeline 'static:1.0:hello=world|@hello'
world
$ bump pipeline 'static:1.0:hello=world|@name'
1.0
$ bump pipeline 'static:1.0:hello=world|key:hello'
world

static

static:<名称[:键=值:...]>,...

从过滤器参数生成版本。

sh
$ bump pipeline 'static:1,2,3,4:key=value:a=b|sort'
4

err

err:<错误>

抛出错误消息。用于测试。

sh
$ bump pipeline 'err:test'
test

想法、待办事项和已知问题

GitHub Action：如何访问包管理器工具？单独的docker镜像？bump-go？在其他镜像中安装bump二进制文件？
GitHub Action：PR标签
GitHub Action：某种测试机制
配置模板、go包等？
为bump自身提供正确的版本号
如何与hg集成

镜像拉取方式

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

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

docker pull docker.xuanyuan.run/mwader/bump:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull mwader/bump:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

mwader/bump

mwader

一个通用的版本跟踪和更新工具，用于自动化管理Makefile、Dockerfile、脚本等文本文件中的依赖版本，支持通过配置文件定义版本检测规则和更新策略。

下载次数: 0状态：社区镜像维护者：mwader仓库类型：镜像最近更新：1 个月前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

镜像标签列表与下载命令

Bump

一个通用的版本跟踪和更新工具。

以下是一个Bumpfile示例，用于将Dockerfile基础镜像版本自动更新到最新的Alpine 3版本：

sh
$ cat Bumpfile
alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
alpine link "发布说明" https://alpinelinux.org/posts/Alpine-$LATEST-released.html
Dockerfile
# 查看当前版本
$ bump current
Dockerfile:1: alpine 3.9.2
# 检查可用更新
$ bump check
alpine 3.13.0
# 查看更新差异
$ bump diff
--- Dockerfile
+++ Dockerfile
@@ -1,2 +1,2 @@
-FROM alpine:3.9.2 AS builder
+FROM alpine:3.13.0 AS builder
 
# 应用更新
$ bump update

实际应用示例可参考https://github.com/wader/static-ffmpeg/blob/master/Dockerfile%EF%BC%8C%E5%85%B6%E4%B8%AD%E9%87%8D%E8%A6%81%E5%BA%93%E9%80%9A%E8%BF%87bump GitHub Action实现自动更新。

GitHub Action

yml
name: '自动版本更新'
on:
  schedule:
    # 分 时 日 月 周 (UTC)
    - cron: '0 9 * * *'
  # 允许手动触发版本更新
  workflow_dispatch:
jobs:
  bump:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
      - uses: wader/bump/action@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

查看action.yml获取输入参数详情。

提供以下不同环境的Action：
wader/bump/action@master：包含git和curl的alpine环境
wader/bump/action/go@master：包含git、curl和go的alpine环境

安装

Docker

Docker Hub镜像：

sh
docker run --rm -v "$PWD:$PWD" -w "$PWD" mwader/bump help

构建镜像：

sh
docker build -t bump .

源码构建

安装go后执行以下命令，可将bump安装到$(go env GOPATH)/bin/bump：

sh
go get github.com/wader/bump/cmd/bump

使用

sh
$ bump help
用法: bump [选项] 命令
选项:
  -e                    要排除的配置名称（逗号分隔）
  -f                    要读取的Bumpfile（默认：Bumpfile）
  -i                    要包含的配置名称（逗号分隔）
  -r                    运行更新命令（默认：false）
  -v                    详细输出（默认：false）

命令:
  version               显示bump自身版本（dev）
  help [FILTER]         显示帮助或指定过滤器的帮助
  list [FILE...]        显示bump配置
  current [FILE...]     显示当前版本
  check [FILE...]       检查可能的版本更新
  update [FILE...]      更新版本
  diff [FILE...]        显示更新将产生的差异
  pipeline PIPELINE     运行过滤器管道

BUMPFILE是包含CONFIG或文件全局模式的文件
FILE是包含EMBEDCONFIG或待检查更新版本的文件
EMBEDCONFIG格式："bump: CONFIG"
CONFIG格式:
  名称 /正则表达式/ 管道 |
  名称 command 命令 |
  名称 after 命令 |
  名称 message 消息 |
  名称 link 标题 URL
名称是配置的标识
正则表达式是包含一个子匹配以查找当前版本的正则
管道是过滤器管道：过滤器|过滤器|...
过滤器:
  git:<仓库> | <仓库.git>
  gitrefs:<仓库>
  docker:<镜像>
  svn:<仓库>
  fetch:<URL> | <http://> | <https://>
  semver:<约束> | semver:<n.n.n-pre+build> | <约束> | <n.n.n-pre+build>
  re:/<正则表达式>/ | re:/<正则表达式>/<模板>/ | /<正则表达式>/ | /<正则表达式>/<模板>/
  sort
  key:<名称> | @<名称>
  static:<名称[:键=值:...]>,...
  err:<错误>

配置

名称是配置的标识。

正则表达式是golang正则表达式，包含一个子匹配用于查找当前版本。

管道是描述如何查找最新合适版本的过滤器管道：过滤器|过滤器|...

Bumpfile

默认情况下，bump在当前目录查找名为Bumpfile的文件。每行可为注释、配置或文件全局模式（用于读取嵌入式配置）。

# 注释
名称 /正则表达式/ 管道
名称 [command|after] 命令
名称 message 消息
名称 link 标题 URL
文件名
全局模式/*

Bumpfile示例：

# 一个bump配置
alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
alpine message 确保同时使用abc进行测试
alpine link "发布说明" https://alpinelinux.org/posts/Alpine-$LATEST-released.html
# 读取配置，检查并更新Dockerfile中的版本
Dockerfile

嵌入式配置

嵌入式配置可将bump配置直接包含在需要检查或更新版本的文件中。

嵌入式配置格式：

bump: 名称 /正则表达式/ 管道

含嵌入式配置的Dockerfile示例：

# bump: alpine /FROM alpine:([\d.]+)/ docker:alpine|^3
FROM alpine:3.9.3 AS builder

更新时运行shell命令

bump: 名称 [command|after] 命令

执行命令时会设置以下环境变量：
$名称：配置名称
$CURRENT：当前版本
$LATEST：可用的最新版本

有两种shell命令类型：command和after。command会替代bump的默认修改操作；after会在bump完成修改后执行。若配置多个命令，将按配置顺序执行。

使用command通过go get更新go.mod和go.sum的Bumpfile示例：

module program

go 1.12

require (
  // bump: leaktest /github.com\/fortytw2\/leaktest v(.*)/ git:https://github.com/fortytw2/leaktest.git|^1
  // bump: leaktest command go get -d github.com/fortytw2/leaktest@v$LATEST && go mod tidy
  github.com/fortytw2/leaktest v1.2.0
)

使用after运行脚本更新下载哈希的Bumpfile示例：

libvorbis after ./hashupdate Dockerfile VORBIS $LATEST

提交和拉取请求消息及链接

名称 message 消息
名称 link "标题" URL

消息、标题和URL中可使用以下变量：
$名称：配置名称
$CURRENT：当前版本
$LATEST：可用的最新版本

通过配置一个或多个message和link，可将消息和链接包含在提交消息和拉取请求中。

示例：

libvorbis link "CHANGES文件" https://github.com/xiph/vorbis/blob/master/CHANGES
libvorbis link "源码差异 $CURRENT..$LATEST" https://github.com/xiph/vorbis/compare/v$CURRENT..v$LATEST

管道

默认所有过滤器操作默认键"name"，可通过key:<名称>或@<名称>在管道中更改默认键。

示例

以下示例使用bump pipeline 管道测试运行管道并显示结果。使用bump -v pipeline 管道可获取更详细的输出，有助于测试管道。

sh
# 最新的4.0版本ffmpeg
$ bump pipeline 'https://github.com/FFmpeg/FFmpeg.git|^4'
4.3.1
# 最新4.0版本ffmpeg的提交哈希
$ bump pipeline 'https://github.com/FFmpeg/FFmpeg.git|^4|@commit'
a3a26a98652fbdaa474e95cfbc12f68b64ca1e6f
# 最新的1.0版本golang docker构建镜像
$ bump pipeline 'docker:golang|^1'
1.15.6
# 最新的mp3lame版本
$ bump pipeline 'svn:http://svn.code.sf.net/p/lame/svn|/^RELEASE__(.*)$/|/_/./|*'
3.100

过滤器

过滤器用于生成、转换和筛选版本。部分过滤器（如git）生成版本，re和semver用于转换和筛选。

git

git:<仓库> 或 <仓库.git>

从git仓库的标签生成版本。"name"为标签中的版本号，"commit"为提交哈希或标签对象。

使用gitrefs过滤器可从所有引用生成版本。

sh
$ bump pipeline 'https://github.com/git/git.git|*'
2.30.0
$ bump pipeline 'git://github.com/git/git.git|*'
2.30.0

gitrefs

gitrefs:<仓库>

从git仓库的所有引用生成版本。"name"为完整引用（如"refs/tags/v2.7.3"），"commit"为提交哈希。

使用git过滤器仅从标签生成版本。

sh
$ bump pipeline 'gitrefs:https://github.com/git/git.git'
HEAD

docker

docker:<镜像>

从Docker Hub镜像生成版本。

sh
$ bump pipeline 'docker:alpine|^3'
3.13.0

svn

svn:<仓库>

从subversion仓库的标签和分支生成版本。"name"为标签或分支名称，"version"为修订号。

sh
$ bump pipeline 'svn:https://svn.apache.org/repos/asf/subversion|*'
1.14.0

fetch

fetch:<URL>、<http://> 或 <https://>

获取URL内容，生成一个版本，"name"键为内容。

sh
$ bump pipeline 'fetch:http://libjpeg.sourceforge.net|/latest release is version (\w+)/'
6b

semver

semver:<约束>、semver:<n.n.n-pre+build>、<约束> 或 <n.n.n-pre+build>

使用语义化版本筛选或转换版本。

提供约束时，用于查找满足约束的最新版本。

提供版本模式时，用于转换版本。

sh
# 查找最新的主版本1版本
$ bump pipeline 'static:1.1.2,1.1.3,1.2.0|semver:^1'
1.2.0
# 查找最新的次版本1.1版本
$ bump pipeline 'static:1.1.2,1.1.3,1.2.0|~1.1'
1.1.3
# 转换为仅主版本.次版本
$ bump pipeline 'static:1.2.3|n.n'
1.2

re

re:/<正则表达式>/、re:/<正则表达式>/<模板>/、/<正则表达式>/ 或 /<正则表达式>/<模板>/

可通过将第一个/替换为其他字符指定替代的正则/模板分隔符，例如：re:#正则表达式#模板#。

使用golang正则表达式筛选名称。若名称不匹配正则表达式，版本将被跳过。

若仅提供正则表达式且无模板和子匹配，名称不变。

若定义子匹配，名为"name"或"value"的子匹配将分别用作名称和值，否则第一个子匹配用作名称。

若定义模板且无匹配子，模板用作替换字符串；若有子匹配，模板用于展开$0、${1}、$name等。

正则表达式可多次匹配。使用^$锚点或(?m:)确保单次匹配或按行匹配。

sh
# 仅筛选
$ bump pipeline 'static:a,b|/b/'
b
# 简单替换
$ bump pipeline 'static:aaa|re:/a/b/'
bbb
# 使用#作为分隔符的简单替换
$ bump pipeline 'static:aaa|re:#a#b#'
bbb
# 第一个子匹配作为名称
$ bump pipeline 'static:ab|re:/a(.)/'
b
# 多子匹配替换
$ bump pipeline 'static:ab:1|/(.)(.)/${0}$2$1/'
abba
# 命名子匹配作为名称和值
$ bump pipeline 'static:ab|re:/(?P<name>.)(?P<value>.)/'
a
$ bump pipeline 'static:ab|re:/(?P<name>.)(?P<value>.)/|@value'
b

sort

sort

按字母逆序排序版本。

sh
$ bump pipeline 'static:a,b,c|sort'
c

key

key:<名称> 或 @<名称>

更改管道的默认键。常用于管道末尾（如使用git提交哈希而非标签名称）或管道中间（如需基于其他键进行正则筛选）。

sh
$ bump pipeline 'static:1.0:hello=world|@hello'
world
$ bump pipeline 'static:1.0:hello=world|@name'
1.0
$ bump pipeline 'static:1.0:hello=world|key:hello'
world

static

static:<名称[:键=值:...]>,...

从过滤器参数生成版本。

sh
$ bump pipeline 'static:1,2,3,4:key=value:a=b|sort'
4

err

err:<错误>

抛出错误消息。用于测试。

sh
$ bump pipeline 'err:test'
test

想法、待办事项和已知问题

GitHub Action：如何访问包管理器工具？单独的docker镜像？bump-go？在其他镜像中安装bump二进制文件？
GitHub Action：PR标签
GitHub Action：某种测试机制
配置模板、go包等？
为bump自身提供正确的版本号
如何与hg集成

镜像拉取方式

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

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

docker pull docker.xuanyuan.run/mwader/bump:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull mwader/bump:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"