anoxis/registry-cli

registry-cli

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

目录

• 安装
  • Docker镜像
  • Python脚本
• 列出镜像
• 用户名和密码
• 删除镜像
• 禁用SSL验证
• Nexus Docker Registry
• 重要说明
  • docker-registry中的垃圾回收
  • 启用docker-registry的镜像删除功能
• 贡献

安装

Docker镜像

您可以下载预安装了脚本和所有Python依赖的Docker镜像：

docker pull anoxis/registry-cli

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

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

注意：如果registry在本地主机上，需链接到registry的网络并使用容器名称（而非localhost）。例如registry容器名为"registry"：

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

Python脚本

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

chmod 755 registry.py

安装依赖：

sudo pip install -r requirements-build.txt

列出镜像

列出所有镜像和标签：

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

列出所有镜像、标签和层：

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

列出特定镜像（如ubuntu和alpine的所有标签）：

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

用户名和密码

可选参数，适用于无认证的不安全registry（不推荐）。格式支持：

-l username:password
-l 'username':'password'
-l "username":"password"

用户名不含冒号，密码可包含多个冒号。

删除镜像

保留最后10个版本（适用于CI）：

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

修改保留数量（如5）：

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

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

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

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

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

禁用SSL验证

适用于自签名证书的registry：

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

Nexus Docker Registry

添加--digest-method flag：

registry.py -l user:pass -r https://example.com:5000 --digest-method GET

重要说明

docker-registry中的垃圾回收

API仅标记删除，需手动执行垃圾回收：

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

启用docker-registry的镜像删除功能

需设置环境变量REGISTRY_STORAGE_DELETE_ENABLED: "true"或修改config.yml，否则会返回405错误。

贡献

欢迎贡献，修改后请运行测试：

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

（测试中模拟无效输入的错误信息属正常）

联系

如需添加功能或贡献，请联系***。