运行中的私有Docker Registry删除镜像遇UNSUPPORTED错误的解决方案咨询

我来一步步帮你搞定这个问题，你遇到的UNSUPPORTED错误确实是因为Registry默认没开启删除功能，而且你担心重启影响现有镜像的顾虑是合理的，但只要操作得当，完全可以安全启用删除并完成镜像清理：

1. 先定位Registry容器的配置与存储路径 #

首先，你得搞清楚你的Registry是怎么部署的——如果是用容器运行的，先通过docker inspect命令查看容器的挂载信息，找到配置文件和镜像存储的实际路径：

docker inspect <你的Registry容器名或ID>

在输出的Mounts段落里，你要找这两个关键点：

• 存储镜像数据的挂载（通常对应容器内的/var/lib/registry）：如果有Source字段，说明数据挂载在宿主机的这个路径下；如果没有，说明数据存在容器内部的文件系统里。
• 配置文件的挂载（通常对应容器内的/etc/docker/registry/config.yml）：同样看是否有宿主机的挂载路径，没有的话说明用的是镜像默认配置。

2. 启用删除功能的配置修改 #

情况一：已有挂载的配置文件 #

直接编辑宿主机上的config.yml，添加或修改storage部分的配置：

storage:
  delete:
    enabled: true
  # 保留原来已有的storage配置，比如filesystem的rootdirectory等

情况二：用默认配置（无挂载的配置文件） #

这时候需要先把容器内的镜像数据导出到宿主机（避免丢失），再创建自定义配置文件：

1. 先停止Registry容器：

   docker stop <你的Registry容器ID>
   

2. 把容器内的镜像数据拷贝到宿主机的某个目录（比如/data/registry）：

   docker cp <你的Registry容器ID>:/var/lib/registry /data/registry
   

3. 在/data/registry目录下创建config.yml，内容如下（包含默认配置+删除功能开启）：

   version: 0.1
   log:
     fields:
       service: registry
   storage:
     delete:
       enabled: true
     filesystem:
       rootdirectory: /var/lib/registry
   http:
     addr: :5000
   

4. 重新启动Registry容器，挂载数据和配置文件：

   docker run -d -p 5000:5000 \
     -v /data/registry:/var/lib/registry \
     -v /data/registry/config.yml:/etc/docker/registry/config.yml \
     registry:2
   

3. 重启Registry（安全无数据丢失） #

不管是修改了已有配置还是重新挂载配置，都需要重启Registry容器：

docker restart <你的Registry容器名或ID>

这里放心，只要镜像数据是挂载在宿主机（或者用了Docker卷），重启只是重启Registry服务，不会丢失任何镜像。

4. 正确执行镜像删除命令 #

注意：你之前用tag直接删除的方式可能无效，Registry的DELETE接口需要用镜像的digest值操作。先获取镜像的digest：

curl -H "Accept: application/vnd.docker.distribution.manifest.v2+json" \
  http://<你的RegistryIP>:5000/v2/lightweighttest/manifests/lightweighttest:1

在返回的响应头里找到Docker-Content-Digest字段（比如sha256:xxxxxx），然后用这个digest执行删除：

curl -X DELETE http://<你的RegistryIP>:5000/v2/lightweighttest/manifests/<刚才获取的digest值>

5. 清理未被引用的镜像数据（垃圾回收） #

删除manifest后，对应的镜像blobs还会留在存储里，需要执行垃圾回收来释放磁盘空间：

docker exec <你的Registry容器名或ID> registry garbage-collect /etc/docker/registry/config.yml

如果想自动清理所有未被引用的资源，可以加--delete-untagged参数：

docker exec <你的Registry容器名或ID> registry garbage-collect --delete-untagged /etc/docker/registry/config.yml

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