# docker registry v2 API 的理解与一些验证

已于 2023-06-08 21:24:34 修改
阅读量1.6k 收藏 3
点赞数
分类专栏： IT 文章标签： docker 运维 容器
于 2022-08-27 15:13:37 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zhf_sy/article/details/126558336
版权

docker registry v2 API 的理解与一些验证

文章目录

API官方文档：https://docs.docker.com/registry/spec/api/

API官方文档翻译：https://docs.docker.com.zh.xy2401.com/registry/spec/api/

1 API methods and URIs ：

MethodPathEntityDescription
GET/v2/BaseCheck that the endpoint implements Docker Registry API V2.
GET/v2/<name>/tags/listTagsFetch the tags under the repository identified by name.某仓库下的tag列表
GET/v2/<name>/manifests/<reference>ManifestFetch the manifest identified by name and reference where reference 可以是镜像 tag 或 digest（要用header里的digest）. A HEAD request can also be issued to this endpoint to obtain resource information without receiving all data.获取某仓库某tag信息清单，带上请求header，可以获得指定信息
PUT/v2/<name>/manifests/<reference>ManifestPut the manifest identified by name and reference where reference can be a tag or digest.
DELETE/v2/<name>/manifests/<reference>ManifestDelete the manifest identified by name and reference. Note that a manifest can only be deleted by digest.（要用header里的镜像digest）
GET/v2/<name>/blobs/<digest>BlobRetrieve the blob from the registry identified by digest. A HEAD request can also be issued to this endpoint to obtain resource information without receiving all data.
DELETE/v2/<name>/blobs/<digest>BlobDelete the blob identified by name and digest（要用config–>digest）
POST/v2/<name>/blobs/uploads/Initiate Blob UploadInitiate a resumable blob upload. If successful, an upload location will be provided to complete the upload. Optionally, if the digest parameter is present, the request body will be used to complete the upload in a single request.
GET/v2/<name>/blobs/uploads/<uuid>Blob UploadRetrieve status of upload identified by uuid. The primary purpose of this endpoint is to resolve the current status of a resumable upload.
PATCH/v2/<name>/blobs/uploads/<uuid>Blob UploadUpload a chunk of data for the specified upload.
PUT/v2/<name>/blobs/uploads/<uuid>Blob UploadComplete the upload specified by uuid, optionally appending the body as the final chunk.
DELETE/v2/<name>/blobs/uploads/<uuid>Blob UploadCancel outstanding upload processes, releasing associated resources. If this is not called, the unfinished uploads will eventually timeout.
GET/v2/_catalogCatalogRetrieve a sorted, json list of repositories available in the registry.仓库列表

说明：

  • 目录manifests：是镜像目录或索引。

  • 目录blobs：是镜像实体。

2 HEAD

英文：https://docs.docker.com/registry/spec/manifest-v2-2/

翻译：https://docs.docker.com.zh.xy2401.com/registry/spec/manifest-v2-2/

  • application/vnd.docker.distribution.manifest.v1+json ：schema1（现有清单格式）
  • application/vnd.docker.distribution.manifest.v2+json ：新的图像清单格式（schemaVersion = 2）
  • application/vnd.docker.distribution.manifest.list.v2+json ：清单列表，又称“胖清单”
  • application/vnd.docker.container.image.v1+json ：容器配置JSON
  • application/vnd.docker.image.rootfs.diff.tar.gzip ：“图层”，作为压缩的tar
  • application/vnd.docker.image.rootfs.foreign.diff.tar.gzip ：“图层”，作为永远不应被推送的压缩后的tar
  • application/vnd.docker.plugin.v1+json ：插件配置JSON

实践总结：

  • application/vnd.docker.distribution.manifest.v2+json ：新的图像清单格式（schemaVersion = 2）
  • 只有他是schemaVersion=2，其他全是1，也只有带这个header输出结果不一样，带其他header或不带header结果都一样

3 不同header及无header时的区别验证

3.1 结果一

# 新的图像清单格式（schemaVersion = 2）
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.distribution.manifest.v2+json'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
60

# 内容输出
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.distribution.manifest.v2+json'  https://docker-repo:5000/v2/ufipf/gc-apply-service/manifests/2023.04.18.084456
{
   "schemaVersion": 2,
   "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
   "config": {
      "mediaType": "application/vnd.docker.container.image.v1+json",
      "size": 5162,
      "digest": "sha256:2b8e71e7c99caef05cd72d948e161fa56ce5425ce7427af5a49913f08874e9dd"   #--是blob digest，前12位是镜像ID，curl -v可输出镜像digest
   },
   "layers": [
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 28567101,
         "digest": "sha256:7b1a6ab2e44dbac178598dabe7cff59bd67233dba0b27e4fbd1f9d4b3c877a54"
      },
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 88117163,
         "digest": "sha256:53c7dc4a9ac0223c923d31eed20d2d62837363b73434429ea8d627763d3fe263"
      },
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 49649255,
         "digest": "sha256:2bedc44fe3bdae9c9c8c550124d4804bba3be27107310b146933355364c8c735"
      },
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 177,
         "digest": "sha256:c91d35002add2410e53530a49e805fe15dd82b5c3dd46442f0e3cd45c201305b"
      },
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 107225654,
         "digest": "sha256:3756da984ea66407ac1a5bbb0fabeec09680bd0832c210e1505fc344ce235b3d"
      },
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 4370,
         "digest": "sha256:1adb283c50915c2f712e5c8a71979ca1cb84ee8218cf580af18457edb825b2a0"
      }
   ]
}

3.2 结果二

以下所有结果全是一样的，不论是不加header，还是加如下header（等于是header加了个寂寞），内容太长，用wc处理了下

# 无header
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}   https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# schema1（现有清单格式）
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.distribution.manifest.v1+json'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# 清单列表，又称“胖清单”
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.distribution.manifest.list.v2+json'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# 容器配置JSON
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.container.image.v1+json'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# “图层”，作为压缩的tar
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.image.rootfs.diff.tar.gzip'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# “图层”，作为永远不应被推送的压缩后的tar
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.image.rootfs.foreign.diff.tar.gzip'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

# 插件配置JSON
curl -s -v -X GET    -u ${DOCKER_REPO_USER}:${DOCKER_REPO_PASSWORD}  -H 'Accept: application/vnd.docker.plugin.v1+json'  https://${DOCKER_REPO}/v2/${DOCKER_REPO_USER}/gc-agent-service/manifests/2022.07.07.094332  | wc -l
139

结论：用【结果二】方式感觉没啥用，用【结果一】方式就够了

4 常用url与目录

# 常用url
https://仓库站点/v2/_catalog
https://仓库站点/v2/【仓库（中间可以包含多个/）】/tags/list
https://仓库站点/v2/【仓库（中间可以包含多个/）】/manifests/【tag|header-->digest】   #-- 删除时，必须用【header-->digest】
https://仓库站点/v2/【仓库（中间可以包含多个/）】/blobs/【config-->digest】

# 几个关键目录
[root@v-192-168-11-79-nexus-dockerreg docker_registry]# ll  /srv/docker/docker_registry/data/docker/registry/v2/repositories/ufipf/gclife-apply-service/
总用量 0
drwxr-xr-x. 3 root root 20 9月  19 2018 _layers
drwxr-xr-x. 4 root root 35 9月  19 2018 _manifests
drwxr-xr-x. 2 root root  6 5月   5 15:51 _uploads
[root@v-192-168-11-79-nexus-dockerreg docker_registry]# 
[root@v-192-168-11-79-nexus-dockerreg docker_registry]# ll  /srv/docker/docker_registry/data/docker/registry/v2/repositories/ufipf/gclife-apply-service/_manifests/
总用量 0
drwxr-xr-x. 3 root root  20 9月  19 2018 revisions
drwxr-xr-x. 7 root root 120 5月   5 16:04 tags
[root@v-192-168-11-79-nexus-dockerreg docker_registry]# ll  /srv/docker/docker_registry/data/docker/registry/v2/repositories/ufipf/gclife-apply-service/_layers/
总用量 12
drwxr-xr-x. 23 root root 8192 5月   5 15:51 sha256
[root@v-192-168-11-79-nexus-dockerreg docker_registry]# ll  /srv/docker/docker_registry/data/docker/registry/v2/blobs/
总用量 12
drwxr-xr-x. 258 root root 8192 9月  15 2018 sha256

5 最后

OK，看完这篇文章，你可能还想看看这篇文章【我实践：用docker registry API 获取清单并删除某仓库某tag镜像：https://blog.csdn.net/zhf_sy/article/details/126558517】

img

爱你！

私有docker registry V2的pull和push流程——HTTP
weixin_44380117的博客
10-11 1770
pull一个镜像的时候客户端要先向registry发送获取manifest请求，获取到manifest后客户端要验证manifest签名的真实性以确保名称（镜像名吗？每个layer都以一个blob的形式存储在registry中，以摘要作为关键字来标识不同的layer。push流程与pull相反，组装好镜像manifest后要先push各个layer，待所有layer都被push到registry中后再上传签名的manifest。通过url中的name和reference参数来标识镜像（必要参数）。
[DockerRegistry]搭建Docker Registry v2
急速虫子
11-07 3672
docker registry v2
Docker Registry API best practice 【Docker Registry API 最佳实践】
最新发布
爱死亡机器人
09-18 952
在执行脚本之前，必须创建一个名为images.txt的文件，其中应该包含计划删除的映像的名称。例如，文件中的一个条目可能如下所示:registry.demo.com/library/nginx:latest。要删除的镜像我们存放到 registry-images-clean.txt 文件中。现在，我们开始删除 registry-images-clean.txt 的镜像。首先，这是一个清理的演示，先批量推送镜像入库。首先，检查当前registry镜像仓库有哪些镜像。服务端(192.168.21.2)配置。
docker registry http api v2(原创请注明出处)
ztsinghua的专栏
05-25 1万+
author: zqh date: 2016-5-24 docker registry v2版本的http api 一直没有找到合适的，自己通过阅读官方文档整理了一下。 概要 method path Entity Description GET /v2/ Base Chec
docker registry v2 API的使用
kan2016的博客
01-08 1万+
1．获取用户认证信息 对用户名和密码，进行base64编码。 格式：echo -n "用户名：密码" | base64 执行命令,得到认证信息。 2．查询镜像是否存在以及标签列表 方法：GET  /v2/&lt;name&gt;/tags/list 其中&lt;name&gt;为镜像名 (1)携带认证信息发起请求 格式：curl -v -H "Authorization: Ba...
Docker Registry HTTP API V2
yzl11的博客
01-14 1567
https://github.com/docker/distribution/blob/master/docs/spec/api.md
关于Docker Registry v2的搭建
热门推荐
B.I.T
06-02 1万+
新版 registry v2对镜像存储格式进行了重新设计，并且和旧版还不兼容。registry v2是由go语言开发，docker从1.6版本开始支持registry v2，之前python开发的老版registry在网上已被标为废弃了（没有维护更新，但也可以用）。 之前在测试环境搭建了一个老版的registry，用了也比较久了。为了跟上技术的脚步，也准备今后使用新版registry v2。
Docker Registry 删除镜像并清理
sinat_28371057的博客
02-27 8852
目录 修改Docker Registry配置 使用Registry V2 RestfulAPI 删除镜像 Docker Registry GC回收空间 使用UI管理Docker Registry 修改Docker Registry配置 配置开启删除功能:config.yml version: 0.1 log: fields: service: registry storage: delete: enabled: true cache:
docker registry检查镜像是否存在
longtails的博客
11-30 6417
docker registry检查镜像是否存在 docker registry v2 API没有提供直接判断一个镜像是否已经存在的api，但是可以通过一些接口组合判断，这里用manifest接口判断该镜像是否已经存在 测试manifests API，存在结果 ➜ ~ curl -X GET "http://registry:5000/v2/nginx/manifests/1.12" { "...
Docker Registry采用token认证实践
wangyijie11的博客
03-21 6416
Docker Registry的Token认证token认证过程图解详细介绍6个步骤Step 1，Client 向registry 发起连接Step 2，未认证响应(Unauthorized response)Step 3&4，认证endpoint通讯Step 5&6，最后沟通方案实践目录层级说明CA创建mongodb存储mongodb容器启动配置建库并写入数据auth_serve...
OCI基于Docker Registry v2协议标准化容器注册表API
cpongo5
05-01 294
\看新闻很累？看技术新闻更累？试试下载InfoQ手机客户端，每天上下班路上听新闻，有趣还有料！\\\Open Container Initiative启动了容器发行规范项目，用以标准化容器镜像注册表的API。它基于Docker Registry协议v2，使用对象为Docker工具集和公有云供应商。\\Docker Registry协议v2是Docker工具集用于在注册表和用户之间推送和拉取镜像的协...
【docker系列】使用registry-v2搭建镜像仓库及完成镜像分发
字母哥博客
05-24 1394
目前广泛应用的Docker 官方提供的私有仓库是Docker Registry V2，下面我们就来学习一下如何搭建及使用它。
【Docker】Docker Registry HTTP API
小子宝丁的博客
04-22 1782
Docker Registry HTTP API 是面向 Docker Registry v2 的 API，用于与 Registry 进行通信以管理 Docker 镜像。
Docker registry V2
weixin_34162695的博客
02-28 129
部署私有Docker Registry 搭建 Insecure Registry 修改Registry server上的Docker daemon的配置，为DOCKER_OPTS增加–insecure-registry：DOCKER_OPTS="--insecure-registry 10.10.105.71:5000重启Docker Daemon，启动Registry容器： #docker...
Docker API（Registry API、Docker Hub API、Docker Remote API）
董哥的黑板报
07-28 4020
一、Docker API简介 在Docker生态系统中一共有3种API： Registry API：提供了与来存储Docker镜像的Docker Registry继承的功能 Docker Hub API：提供了与Docker Hub继承的功能 Docker Remote API：提供与Docker守护进程集成的功能 这3种API都是RESTful风格的 本文我们主要介绍Remote API，因为它是通过程序与Docker进行继承和交互的核心内容 二、初识Remote API Remo
docker registry api
凤歌
07-19 1300
v2: https://docs.docker.com/registry/spec/api/#/get-tags获取镜像其下的tags: http://docker.mydocker.cn:1000/v2/dev.myimage.cn/tags/list
Docker registry V2 推送镜像、拉取镜像、搜索镜像、删除镜像和垃圾回收
锐意工作室
06-15 1万+
官方文档 Registry操作 推送一个镜像到registry 从registry拉取一个镜像 在registry中搜索一个镜像 删除registry中的镜像 垃圾回收 参考文档 官方文档 Docker Registry HTTP API V2 Garbage collection Registry操作 推送一个镜像到registry # docker pus...
搭建Docker Registry v2
IT_BOY__的博客
11-13 696
一、搭建Docker Registry v2 1）预装好docker服务 yum install docker -y systemctl enable docker systemctl start docker 2）获取最新的registry的容器 了解到目前最新版为2.4.1，于是直接使用docker pull命令从公用仓库去拉即可 docker p
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值