lhanxetus/deckschrubber

Deckschrubber

n. 负责擦洗船甲板的人

Deckschrubber用于检查Docker Registry中的镜像，并删除超过指定年龄的镜像，帮助维护Registry的存储空间。

核心功能

• 按时间条件（年、月、日）删除旧镜像
• 支持按仓库名称或正则表达式过滤目标仓库
• 按标签正则表达式筛选需删除的镜像
• 保留每个仓库的最新N个镜像不被删除
• 提供调试模式和模拟删除（dry run）功能
• 支持带认证的Registry访问及忽略HTTPS验证

使用场景

1. Registry存储占用过大，需定期清理旧镜像
2. 删除特定标签（如快照版本）的镜像
3. 保留仓库中最新的若干镜像，移除历史版本
4. 批量清理指定仓库的旧镜像

配置参数

-v    显示版本信息并退出
-debug
      以调试模式运行
-dry
      模拟删除（不实际执行删除操作）
-registry string
      Registry的URL（默认值："http://localhost:5000"）
-username string
      Docker登录用户名
-password string
      Docker登录密码
-insecure
      忽略HTTPS验证错误
-repos
      匹配的仓库名称（允许多值，用逗号分隔；指定后将忽略-repo_regexp）
-repo_regexp string
      匹配仓库的正则表达式（默认值：".*"）
-max_repos int
      垃圾回收的最大仓库数量（默认无限制）
-tag_regexp string
      匹配标签的正则表达式（默认值：".*"）
-latest int
      每个仓库保留的最新镜像数量（默认值：1）
-year int
      最大年龄（年）
-month int
      最大年龄（月）
-day int
      最大年龄（日）

部署示例

• 删除所有超过2个月2天的镜像

docker run --rm --name registry-retention-runner lhanxetus/deckschrubber -month 2 -day 2

• 从http://myrepo:5000删除超过1年的指定仓库镜像

docker run --rm --name registry-retention-runner lhanxetus/deckschrubber -year 1 -registry http://myrepo:5000 -repos myproject/myimage,myproject/otherimage -username myself -password mypwd

• 每个仓库保留最新3个镜像，删除其余

docker run --rm --name registry-retention-runner lhanxetus/deckschrubber -latest 3

• 删除所有标签以'-SNAPSHOT'结尾的镜像

docker run --rm --name registry-retention-runner lhanxetus/deckschrubber -tag_regexp '^.*-SNAPSHOT

https://github.com/x-lhan/deckschrubber

https://github.com/x-lhan/deckschrubber