hyperdev/registry-cli

registry-cli

registry.py是一个用于从命令行（或脚本）轻松操作Docker Registry的工具。

安装方式

Docker镜像

可直接拉取预安装好依赖的Docker镜像：

bash
docker pull anoxis/registry-cli

使用时，将命令中的registry.py替换为docker run --rm anoxis/registry-cli，例如：

bash
docker run --rm anoxis/registry-cli -r http://example.com:5000

注意：若Registry在本地（localhost），需链接Registry容器网络并使用容器名访问（如容器名为registry）：

bash
docker run --rm --link registry anoxis/registry-cli -r http://registry:5000

Python脚本

下载registry.py并设置可执行权限：

bash
chmod 755 registry.py

安装依赖：

bash
sudo pip install -r requirements.txt

核心功能

列出镜像

• 列出所有镜像及标签：

  bash
  registry.py -l user:pass -r https://example.com:5000
  

• 列出镜像、标签及层：

  bash
  registry.py -l user:pass -r https://example.com:5000 --layers
  

• 列出指定镜像（如ubuntu、alpine）：

  bash
  registry.py -l user:pass -r https://example.com:5000 -i ubuntu alpine
  

删除镜像

• 保留最新10个标签（适用于CI场景）：

  bash
  registry.py -l user:pass -r https://example.com:5000 --delete
  

• 自定义保留标签数量（如5个）：

  bash
  registry.py -l user:pass -r https://example.com:5000 --delete --num 5
  

• 按正则删除标签（如含"snapshot-"或以"stable-四位数字"开头）：

  bash
  registry.py -l user:pass -r https://example.com:5000 --delete --tags-like "snapshot-" "^stable-[0-9]{4}.*"
  

• 删除指定镜像的所有标签（如ubuntu）：

  bash
  registry.py -l user:pass -r https://example.com:5000 -i ubuntu --delete-all
  

其他配置

• 禁用SSL验证（适用于自签名证书）：

  bash
  registry.py -l user:pass -r https://example.com:5000 --no-validate-ssl
  

重要注意事项

Registry垃圾回收

Docker Registry API仅标记镜像为删除状态，需手动执行垃圾回收清理空间：

bash
# Docker Compose场景
cd [docker-compose.yml所在目录]
docker-compose stop registry
docker-compose run --rm registry bin/registry garbage-collect /etc/docker/registry/config.yml
docker-compose up -d registry

# 非Compose场景
docker stop registry:2
docker run --rm registry:2 bin/registry garbage-collect /etc/docker/registry/config.yml
docker start registry:2

启用删除功能

需在Registry中开启删除功能：

• 环境变量：REGISTRY_STORAGE_DELETE_ENABLED: "true"
• 或在config.yml中添加对应配置，否则会返回405错误。

使用场景

• CI/CD流水线中自动清理旧镜像，释放存储空间；
• 批量管理私有Registry中的镜像，按规则删除无用标签；
• 脚本化操作Registry，提升镜像管理效率。

贡献与联系

欢迎贡献代码，修改后请运行测试确保功能正常：

bash
pip install -r requirements-test.txt
python test.py

如有问题或需求，可联系：***。