delete-docker-registry-image快速入门：3步清理私有仓库冗余镜像

delete-docker-registry-image快速入门：3步清理私有仓库冗余镜像

【免费下载链接】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 Registry v2设计的高效清理工具，能够帮助管理员彻底删除冗余镜像和标签，释放宝贵的存储空间。本文将通过3个简单步骤，教你如何快速上手这款实用工具。

一、工具准备：轻松获取与基础配置

1.1 克隆项目代码库

首先，将项目代码克隆到本地环境：

git clone https://gitcode.com/gh_mirrors/de/delete-docker-registry-image cd delete-docker-registry-image

1.2 了解核心脚本功能

项目提供两个主要Python脚本，均采用#!/usr/bin/env python声明，确保跨环境兼容性：

• delete_docker_registry_image.py：核心删除功能脚本，支持直接删除指定镜像或标签
• clean_old_versions.py：批量清理工具，可按规则（如保留最新N个标签、按日期筛选）自动清理历史版本

二、核心操作：3步完成镜像清理

2.1 查看帮助文档，确认参数选项

使用-h参数查看工具支持的所有操作选项，这是新手入门的最佳方式：

基础删除工具帮助：

python delete_docker_registry_image.py -h

主要参数包括：

• --image：指定要清理的Docker镜像名称
• --dry-run：模拟删除操作，不实际执行
• --verbose：显示详细操作过程
• --prune：清理孤立的镜像层数据

批量清理工具帮助：

python clean_old_versions.py -h

特色参数包括：

• --last：保留最新的N个标签
• --before-date：仅删除指定日期前创建的标签
• --include-tags/--exclude-tags：通过正则表达式筛选标签
• --dry-run：安全预览清理结果

2.2 执行安全删除：先模拟后执行

为避免误操作，建议先使用--dry-run参数进行模拟删除，确认操作结果符合预期：

示例：模拟删除单个镜像标签

python delete_docker_registry_image.py \ --image myproject/myapp \ --tag v1.0.0 \ --dry-run \ --verbose

示例：批量清理历史版本（保留最新5个标签）

python clean_old_versions.py \ --image myproject/myapp \ --last 5 \ --dry-run \ --verbose

2.3 执行实际删除操作

确认模拟结果无误后，移除--dry-run参数执行实际删除：

删除指定标签

python delete_docker_registry_image.py \ --image myproject/myapp \ --tag v1.0.0 \ --verbose

按日期清理旧标签

python clean_old_versions.py \ --image myproject/myapp \ --before-date 2023-01-01 \ --verbose

三、高级应用：定制化清理策略

3.1 使用正则表达式筛选标签

通过--include-tags和--exclude-tags参数，可以灵活匹配需要清理的标签：

# 仅清理测试环境标签 python clean_old_versions.py \ --image myproject/myapp \ --include-tags "test-.*" \ --last 3 \ --verbose

3.2 结合认证信息使用

如果私有仓库需要认证，可通过--user和--password参数提供凭据：

python delete_docker_registry_image.py \ --image myproject/myapp \ --tag v1.0.0 \ --registry-url https://registry.example.com \ --user admin \ --password securepassword

四、注意事项与最佳实践

1. 操作前备份：执行删除操作前，建议备份Registry数据目录，防止意外数据丢失
2. 定期清理：可将清理命令加入crontab，实现自动化定期清理
3. 先小范围测试：首次使用时，建议选择非关键镜像进行测试，熟悉工具特性
4. 配合监控使用：清理后通过监控工具确认存储空间释放情况

通过以上步骤，你已经掌握了delete-docker-registry-image工具的基本使用方法。这款轻量级工具虽然没有复杂的界面，但通过灵活的命令行参数，能够满足各种私有Docker仓库的清理需求，帮助你有效管理镜像存储，提升系统性能。

【免费下载链接】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