首先列出docker registry官方API的地址:Registry API,然后还有使用手册:Docker Registry。
Docker Registry使用:
1、开始一个registry:
docker run -d -p 5000:5000 \
--name registry --restart=always \
-v 'pwd'/registry:/var/lib/registry \
registry:2
如果需要配置文件的话,则加上配置文件挂载。(config详细信息)
docker run -d -p 5000:5000 \
--name registry --restart=always \
-v 'pwd'/registry:/var/lib/registry \
-v 'pwd'/config.yml:/etc/docker/registry/config.yml \
registry:2
2、配置daemon.json,/etc/docker/daemon.json增加一行,然后systemctl restart docker:
{
"insecure-registries": ["127.0.0.1:5000"]
}
3、上传一个镜像
先要给本地镜像重新tag,例如下面的test是待上传的镜像,localhost:5000/my_test是tag之后的
docker image tag test localhost:5000/my_test
然后docker push localhost:5000/my_test。
Registry API使用
1、查看API是否可用:curl -I -X GET localhost:5000/v2/,返回200 OK代表可用。
2、查看所有镜像:curl -X GET localhost:5000/v2/_catalog
3、获取一个镜像的manifest:
curl -I -X GET localhost:5000/v2/<name>/manifests/<reference>,
<name>代表镜像名,reference可以使用tag或digest。
4、查看一个镜像是否存在:
curl -I -X HEAD localhost:5000/v2/<name>/manifests/<reference>,会返回以下信息
200 OK
Content-Length: <length of manifest>
Docker-Content-Digest: <digest>
5、下载单个镜像层:
curl -X GET localhost:5000/v2/<name>/blobs/<digest>
6、删除一个镜像
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: true
还有一些其他的,可以去看Registry API的文档
Registry存储细节
目录分为两层:blobs和repositories。
- blobs:镜像所有内容的实际存储,包括了镜像层和镜像元信息manifest。
- repositories是镜像元信息存储的地方,name代表仓库名称
- 每一个仓库下面又分为_layers、_manifests两个部分
- _layers负责记录该仓库引用了哪些镜像层文件
- _manifests负责记录镜像的元信息
- revisions包含了仓库下曾经上传过的所有版本的镜像元信息
- tags包含了仓库中的所有标签
- current记录了当前标签指向的镜像
- index目录则记录了标签指向的历史镜像