Docker：私有镜像仓库 registry

focus_lyh

已于 2022-10-12 17:10:32 修改

阅读量401

点赞数

分类专栏： # Docker 文章标签： docker kubernetes 容器

于 2022-10-11 23:23:24 首次发布

本文链接：https://blog.csdn.net/focus_lyh/article/details/127271962

版权

Docker 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

文章目录

一、Docker Registry 部署
二、Registry API 使用
三、Registry 存储细节
四、补充扩展
五、registry 认证

参考链接：
官方API的地址： Registry API 使用手册： Docker Registry

一、Docker Registry 部署

step1 启动一个 registry

docker run -d -p 5000:5000  \
--name registry --restart=always \
-v /registry:/var/lib/registry \
registry

推送试试：

[root@jumper k8s-deploy]# docker tag registry 192.168.56.10:5000/registry
[root@jumper k8s-deploy]# docker push 192.168.56.10:5000/registry
The push refers to repository [192.168.56.10:5000/registry]
Get https://192.168.56.10:5000/v2/: http: server gave HTTP response to HTTPS client

报错原因：
client 通过 https 协议 push 镜像，但是 server 端使用的是 http 协议，并没有配置 https 协议。
解决方案：
把私有镜像仓库加到信任的仓库列表中，具体配置如下：

step2 client 指定仓库通过 http 传输数据

vim /etc/docker/daemon.json
{
  "insecure-registries": ["192.168.56.10:5000"]
}

step3 日常使用

# 打标签
docker tag registry 192.168.56.10:5000/registry
# 上传
docker push 192.168.56.10:5000/registry
# 拉取
docker pull 192.168.56.10:5000/registry

step4 美化化 tag

# 部署 registry 时端口配置为80端口,或做个nginx反代到端口5000（这里不演示）
docker run -d -p 80:5000  \
--name registry --restart=always \
-v /registry:/var/lib/registry \
registry
# 配置hosts
echo 'registry.local' >> /etc/hosts
# 配置仓库走http协议
vim /etc/docker/daemon.json
{
"insecure-registries": ["http://registry.local"]
}
# 重启docker生效配置
systemctl restart docker
# 效果展示
docker tag registry registry.local/registry
docker push registry.local/registry

二、Registry API 使用

查看API是否可用，返回200 OK代表可用
```
curl -I -X GET localhost:5000/v2/
```
查看所有镜像
```
curl -X GET localhost:5000/v2/_catalog
```
获取一个镜像的 manifest
```
curl -I -X GET localhost:5000/v2/<name>/manifests/<reference>
```
代表镜像名，reference可以使用 tag 或 digest
查看一个镜像是否存在
```
curl -I -X HEAD localhost:5000/v2/<name>/manifests/<reference>
```
存在：HTTP/1.1 200 OK 不存在：HTTP/1.1 404 Not Found

下载单个镜像层

curl -X GET localhost:5000/v2/<name>/blobs/<digest>

删除一个镜像

curl -I -X DELETE localhost:5000/v2/<name>/manifests/<reference>

不过删除一个镜像需要加一个header，如下：

curl -I --header "Accept: application/vnd.docker.distribution.manifest.v2+json" -X DELETE localhost:5000/v2/<name>/manifests/<reference>

同时还需要在配置中许可删除操作，修改配置文件，在storage下添加delete的许可：

storage:
	delete:
		enabled: tru

三、Registry 存储细节

在这里插入图片描述
目录分为两层：blobs 和 repositories：

blobs：镜像所有内容的实际存储，包括了镜像层和镜像元信息manifest。
repositories：镜像元信息存储的地方，name代表仓库名称

每个仓库下面又分为_layers、_manifests两个部分：

_layers负责记录该仓库引用了哪些镜像层文件
_manifests负责记录镜像的元信息

每个 manifests 又分为revisions、tags两个部分：

revisions包含了仓库下曾经上传过的所有版本的镜像元信息
tags包含了仓库中的所有标签

每个tags又分为 current、index 两个部分

current 记录了当前标签指向的镜像
index 目录则记录了标签指向的历史镜像

四、补充扩展

4.1 查看镜像列表

[root@jumper repositories]# curl -X GET localhost:5000/v2/_catalog
{"repositories":["nginx","registry"]}

或者

[root@jumper repositories]# ls /registry/docker/registry/v2/repositories
nginx  registry

或者
在这里插入图片描述

4.2 查看镜像tag

[root@jumper repositories]# curl -X GET localhost:5000/v2/nginx/tags/list
{"name":"nginx","tags":["latest","v3.1"]}

或者

[root@jumper tags]# ls /registry/docker/registry/v2/repositories/nginx/_manifests/tags
latest  v3.1

或者
在这里插入图片描述

4.3 删除镜像

step1 进入docker registry的容器中
```
docker exec -it registry /bin/sh
```

step2 删除repo

rm -rf /var/lib/registry/docker/registry/v2/repositories/nginx

step3 清除掉blob（垃圾回收，有效层会被标记，无效层会被清理）
```
registry garbage-collect /etc/docker/registry/config.yml
```

五、registry 认证

5.1 添加认证（服务端）

部署认证功能

# 准备 registry 密码文件的存放目录，后续挂载到 registry 容器里面
mkdir -p /opt/registry-var/auth/
# 通过 htpasswd 生成加密后的密码文件
yum -y install httpd-tools
htpasswd -Bbn userA 123456 >> /opt/registry-var/auth/htpasswd

# 启动容器
docker run -d -p 5000:5000 \
-v /opt/registry-var/auth/:/auth/ \			# 载入密码文件
-v /opt/myregistry:/var/lib/registry \		# 载入原先已上传的images
-e "REGISTRY_AUTH=htpasswd" \
-e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \
-e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
registry