专属域名
文档搜索
轩辕助手
Run助手
邀请有礼
返回顶部
快速返回页面顶部
收起
收起工具栏
轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像

交易
充值流量我的订单
工具
提交工单镜像收录一键安装
Npm 源Pip 源Homebrew 源
帮助
常见问题轩辕镜像免费版
其他
关于我们网站地图
热门搜索:
bump

mwader/bump

mwader

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

下载次数: 0状态:社区镜像维护者:mwader仓库类型:镜像最近更新:17 天前
轩辕镜像,快一点,稳很多。点击查看
中文简介
标签下载
镜像标签列表与下载命令
轩辕镜像,快一点,稳很多。点击查看

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:<标签>

更多 bump 镜像推荐

treeder/bump logo

treeder/bump

treeder
暂无描述
3 次收藏10万+ 次下载
1 年前更新
cloudfoundry/stemcell-version-bump-resource logo

cloudfoundry/stemcell-version-bump-resource

cloudfoundry
暂无描述
100万+ 次下载
27 天前更新
bumpah/scoville-image-processor logo

bumpah/scoville-image-processor

bumpah
暂无描述
5万+ 次下载
12 个月前更新

查看更多 bump 相关镜像

轩辕镜像配置手册

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

Harbor 镜像源配置

Harbor Proxy Repository 对接专属域名

Portainer 镜像源配置

Portainer Registries 加速拉取

Nexus 镜像源配置

Nexus3 Docker Proxy 内网缓存

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

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

镜像拉取常见问题

使用与功能问题

配置了专属域名后,docker search 为什么会报错?

docker search 限制

Docker Hub 上有的镜像,为什么在轩辕镜像网站搜不到?

站内搜不到镜像

机器不能直连外网时,怎么用 docker save / load 迁镜像?

离线 save/load

docker pull 拉插件报错(plugin v1+json)怎么办?

插件要用 plugin install

WSL 里 Docker 拉镜像特别慢,怎么排查和优化?

WSL 拉取慢

轩辕镜像安全吗?如何用 digest 校验镜像没被篡改?

安全与 digest

第一次用轩辕镜像拉 Docker 镜像,要怎么登录和配置?

新手拉取配置

轩辕镜像合规吗?轩辕镜像的合规是怎么做的?

镜像合规机制

错误码与失败问题

docker pull 提示 manifest unknown 怎么办?

manifest unknown

docker pull 提示 no matching manifest 怎么办?

no matching manifest(架构)

镜像已拉取完成,却提示 invalid tar header 或 failed to register layer 怎么办?

invalid tar header(解压)

Docker pull 时 HTTPS / TLS 证书验证失败怎么办?

TLS 证书失败

Docker pull 时 DNS 解析超时或连不上仓库怎么办?

DNS 超时

docker 无法连接轩辕镜像域名怎么办?

域名连通性排查

Docker 拉取出现 410 Gone 怎么办?

410 Gone 排查

出现 402 或「流量用尽」提示怎么办?

402 与流量用尽

Docker 拉取提示 UNAUTHORIZED(401)怎么办?

401 认证失败

遇到 429 Too Many Requests(请求太频繁)怎么办?

429 限流

docker login 提示 Cannot autolaunch D-Bus,还算登录成功吗?

D-Bus 凭证提示

为什么会出现「单层超过 20GB」或 413,无法加速拉取?

413 与超大单层

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别?

免费版与专业版区别

轩辕镜像支持哪些 Docker 镜像仓库?

支持的镜像仓库

镜像拉取失败还会不会扣流量?

失败是否计费

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办?

KYSEC 拦截脚本

如何在轩辕镜像申请开具发票?

申请开票

怎么修改轩辕镜像的网站登录和仓库登录密码?

修改登录密码

如何注销轩辕镜像账户?要注意什么?

注销账户

配置与原理类

写了 registry-mirrors,为什么还是走官方或仍然报错?

mirrors 不生效

怎么用 docker tag 去掉镜像名里的轩辕域名前缀?

去掉域名前缀

如何拉取指定 CPU 架构的镜像(如 ARM64、AMD64)?

指定架构拉取

用轩辕镜像拉镜像时快时慢,常见原因有哪些?

拉取速度原因

为什么拉取镜像的 :latest 标签,拿到的往往不是「最新」镜像?

latest 与「最新」

查看全部问题→

用户好评

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

用户头像

oldzhang

运维工程师

Linux服务器

5

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

轩辕镜像
镜像详情
...
mwader/bump
博客Docker 镜像公告与技术博客
热门查看热门 Docker 镜像推荐
安装一键安装 Docker 并配置镜像源
镜像拉取问题咨询请 提交工单,官方技术交流群:1072982923。轩辕镜像所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
镜像拉取问题咨询请提交工单,官方技术交流群:。轩辕镜像所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
商务合作:点击复制邮箱
©2024-2026 源码跳动
商务合作:点击复制邮箱Copyright © 2024-2026 杭州源码跳动科技有限公司. All rights reserved.