如何删除本地Docker Registry中的镜像标签？

提问（中文翻译） #

我在Podman上运行一个容器化的Docker Registry，学习期间向本地Registry推送了同一镜像的多个标签。但我无法移除Registry中的标签：我可以用命令podman rmi [IMAGE]移除本地存储镜像的标签，不过对本地Registry中的标签执行该命令时，即使podman images能看到它，命令也找不到该标签。我忽略了什么？

核心误区 #

podman rmi仅作用于本地主机存储的镜像与标签，你在podman images里看到的本地Registry镜像条目，只是本地缓存的元数据，并非真实存储在本地。这个命令根本没有能力直接操作Registry服务端上的内容，所以会出现“找不到标签”的报错。

删除Registry中标签的正确流程 #

1. 开启Registry的删除功能 #

默认情况下，容器化Registry禁用了删除操作。需要修改Registry的配置文件（通常是/etc/docker/registry/config.yml），添加删除启用配置：

version: 0.1
storage:
  delete:
    enabled: true

修改后重启Registry容器，让配置生效。

2. 获取标签对应的镜像清单哈希 #

要删除标签，需要先拿到它对应的镜像清单摘要（Digest），可以用skopeo工具快速获取：

skopeo inspect docker://<registry地址>:<端口>/<镜像名>:<标签> | jq -r '.Digest'

如果没有skopeo，也可以通过curl请求获取响应头里的哈希：

curl -I http://<registry地址>:<端口>/v2/<镜像名>/manifests/<标签>

从返回的Docker-Content-Digest字段里提取哈希值。

3. 发送删除请求到Registry #

用curl向Registry的API发送删除请求：

curl -X DELETE http://<registry地址>:<端口>/v2/<镜像名>/manifests/<刚才获取的Digest>

4. 清理Registry存储垃圾 #

删除标签后，Registry的存储里会残留未被引用的镜像层，需要执行垃圾回收命令彻底清理：

podman exec <Registry容器名> registry garbage-collect /etc/docker/registry/config.yml

补充说明 #

• 如果你只是想删掉本地podman images里显示的远程镜像缓存，直接用podman rmi <registry地址>:<端口>/<镜像名>:<标签>即可，但这不会影响Registry服务端的内容。
• 同一镜像的多个标签共享底层镜像层，删除单个标签不会删除镜像本身，只有当所有标签都被删除且无其他引用时，垃圾回收才会清理镜像层数据。

内容的提问来源于stack exchange，提问作者livanov