【Docker】专题六：Docker Registry 详解

以下内容均来自个人笔记并重新梳理，如有错误欢迎指正！如果对您有帮助，烦请点赞、关注、转发！欢迎扫码关注个人公众号！

---

目录

一、基本介绍

二、Registry 创建方法

三、Registry 常用 API 请求

四、Registry 镜像清理

---

一、基本介绍

笔者在【Docker】专题一：Docker 基本架构 中介绍过 Docker Registry，它是 Docker 镜像仓库，用于存放和管理 Docker 镜像。

本文将专题介绍本地镜像仓库的创建方法、API 请求、镜像清理等内容。

---

二、Registry 创建方法

使用 DockerHub 上 Registry 官方镜像直接运行容器即可，并挂载本地数据目录。

# 创建容器并后台运行，设置目录、端口映射
docker run -d \
-p 5000:5000 \
-v /var/lib/local_registry:/var/lib/registry \
--name local_registry \
registry:latest


# docker ps 查看容器状态
# 此时私有镜像名称格式为：127.0.0.1:5000/test:latest

---

三、Registry 常用 API 请求

附官方文档地址：Registry | Docker Docs

# 查看 repository 列表
curl 127.0.0.1:5000/v2/_catalog

# 查看镜像 tag 列表
curl 127.0.0.1:5000/v2/<repository>/tags/list

# 查看镜像 tag 对应的 digest
curl -s 127.0.0.1:5000/v2/<repository>/manifests/<tag> -I -H 'Accept: application/vnd.docker.distribution.manifest.v2+json' | grep Docker-Content-Digest | awk '{print $NF}' | tr -d '\r'

---

四、Registry 镜像清理

1、前提条件

需要在 /etc/docker/registry/config.yml 文件中配置允许删除镜像（storage.delete.enabled）。

version: 0.1
log:
  fields:
    service: registry
storage:
  cache:
    blobdescriptor: inmemory
  filesystem:
    rootdirectory: /var/lib/registry
  # 添加 delete 字段，允许删除镜像
  delete:
    enabled: true
http:
  addr: :5000
  headers:
    X-Content-Type-Options: [nosniff]
health:
  storagedriver:
    enabled: true
    interval: 10s
    threshold: 3

运行 Registry 容器时挂载该配置文件即可：

docker run -d \
-p 5000:5000 \
-v /var/lib/local_registry:/var/lib/registry \
-v /etc/docker/config.yml:/etc/docker/registry/config.yml
--name local_registry \
registry:latest

2、清理步骤

# 第一步：参考常用 API 请求，自行获取镜像的 repository 和 digest 信息

# 第二步：删除镜像
curl -I -XDELETE 127.0.0.1:5000/v2/<repository>/manifests/<digest>

# 第三步：垃圾回收
docker exec local_registry bin/registry garbage-collect /etc/docker/registry/config.yml

🔔 官方说明：删除镜像时必须指定 digest 信息而非 tag 信息。