从安装到使用：delete-docker-registry-image新手必备指南

【免费下载链接】delete-docker-registry-imageIf you are running a private v2 docker registry, and you are storing your data on disk, running this script from the machine where the data lives will let you fully delete an image or tag项目地址: https://gitcode.com/gh_mirrors/de/delete-docker-registry-image

delete-docker-registry-image是一款专为Docker私有仓库设计的高效清理工具，能帮助用户彻底删除指定镜像或标签，释放宝贵的存储空间。本文将从安装到使用，为新手提供一份简单快速的完整指南，让你轻松掌握Docker镜像清理技巧。

为什么需要delete-docker-registry-image？

随着Docker镜像的不断积累，私有仓库的存储空间会迅速膨胀。默认情况下，Docker Registry并不提供直接删除镜像的功能，这时候delete-docker-registry-image就派上用场了！它可以：

✅ 彻底删除指定镜像或标签
✅ 清理未使用的镜像层，释放磁盘空间
✅ 支持按规则批量清理旧版本镜像
✅ 提供安全的干运行模式，避免误操作

简单两步完成安装

安装delete-docker-registry-image非常简单，只需在终端执行以下命令：

curl https://raw.githubusercontent.com/burnettk/delete-docker-registry-image/master/delete_docker_registry_image.py | sudo tee /usr/local/bin/delete_docker_registry_image >/dev/null sudo chmod a+x /usr/local/bin/delete_docker_registry_image

执行完成后，你就可以在系统任何位置使用delete_docker_registry_image命令了。

开始使用前的准备工作

在使用工具前，需要先进行一些简单的配置：

1. 停止Docker Registry服务
   为避免竞争条件和数据丢失，清理前必须关闭 registry 服务：

   sudo systemctl stop docker-registry

2. 设置数据目录环境变量
   指定你的Docker Registry数据存储路径：

   export REGISTRY_DATA_DIR=/opt/registry_data/docker/registry/v2

   你也可以直接编辑delete_docker_registry_image.py文件修改默认路径。

基本使用方法：3种常用场景

场景1：安全测试删除（干运行模式）

在实际删除前，建议先使用--dry-run参数进行测试，查看会删除哪些内容：

delete_docker_registry_image --image testrepo/awesomeimage --dry-run

场景2：删除整个镜像仓库

如果你想删除整个镜像仓库（包括所有标签），使用以下命令：

delete_docker_registry_image --image testrepo/awesomeimage

场景3：只删除特定标签

如需保留镜像但删除某个特定标签，只需在镜像名后加上标签：

delete_docker_registry_image --image testrepo/awesomeimage:supertag

高级功能：批量清理旧版本镜像

项目还提供了clean_old_versions.py脚本，支持按规则批量清理旧版本镜像。例如，保留最新的2个标签，删除2016年1月1日至6月25日期间创建的0.1.x版本标签：

./clean_old_versions.py --image '^repo/sitor*' --include '^0.1.*' -l 2 -b 2016-06-25T12:00:00 -a 2016-01-01T00:00:00 --registry-url http://localhost:5000

同样，添加--dry-run参数可以先预览清理效果。

使用注意事项

⚠️重要提示：

• 操作前务必停止Docker Registry服务
• 建议先使用--dry-run模式测试清理效果
• 清理后需要重启Docker Registry服务
• 不同版本组合可能存在兼容性问题，已知测试通过的配置：
  • docker: 1.9.1, registry:2.2.1
  • docker: 1.10.2, registry:2.3.0
  • docker: 1.11.2, registry:2.3.0
  • docker: 1.12.1, registry:2.5.0

总结

delete-docker-registry-image是管理Docker私有仓库的实用工具，通过简单的命令就能帮助你有效清理无用镜像，释放存储空间。无论是单个镜像删除还是批量清理，都能轻松应对。按照本文指南操作，即使是新手也能快速掌握镜像清理技巧！

如果需要获取更多帮助，可以查看项目中的测试脚本test/test或探索测试目录test/中的更多资源。

【免费下载链接】delete-docker-registry-imageIf you are running a private v2 docker registry, and you are storing your data on disk, running this script from the machine where the data lives will let you fully delete an image or tag项目地址: https://gitcode.com/gh_mirrors/de/delete-docker-registry-image