【Docker】Docker Registry HTTP API

目标

归纳列出 Docker Registry Http API 。

Docker Registry HTTP API 是面向 Docker Registry v2 的 API，用于与 Registry 进行通信以管理 Docker 镜像。常用的 API 如下：

1. 检查 API 版本

   请求路径: GET /v2/

   参数列表: 无

   返回值: 如果成功，返回 200 OK，表示正在使用 Docker Registry v2 API。

2. 获取镜像仓库的所有标签

   请求路径: GET /v2/<name>/tags/list

   参数列表:

   • name: 镜像仓库名称

   返回值: 成功时返回一个 JSON 对象，包含仓库的所有标签。

   示例:

   {
     "name": "repository",
     "tags": ["tag1", "tag2"]
   }
   ```
   
   

3. 拉取镜像的 manifest

   请求路径: GET /v2/<name>/manifests/<reference>

   参数列表:

   • name: 镜像仓库名称
   • reference: 镜像标签或摘要

   返回值: 成功时返回镜像的 manifest，它是一个 JSON 对象。

4. 推送镜像的 manifest

   请求路径: PUT /v2/<name>/manifests/<reference>

   参数列表:

   • name: 镜像仓库名称
   • reference: 镜像标签或摘要

   返回值: 成功时返回 201 Created，表示已成功推送镜像的 manifest。

5. 删除镜像

   请求路径: DELETE /v2/<name>/manifests/<reference>

   参数列表:

   • name: 镜像仓库名称
   • reference: 镜像摘要

   返回值: 成功时返回 202 Accepted，表示已成功删除镜像。

6. 拉取镜像的 blob

   请求路径: GET /v2/<name>/blobs/<digest>

   参数列表:

   • name: 镜像仓库名称
   • digest: blob 的摘要

   返回值: 成功时返回镜像的 blob（二进制数据）。

7. 推送镜像的 blob

   请求路径: PUT /v2/<name>/blobs/uploads/<uuid>?digest=<digest>

   参数列表:

   • name: 镜像仓库名称
   • uuid: 上传的 UUID
   • digest: blob 的摘要

   返回值: 成功时返回 201 Created，表示已成功推送镜像的 blob。

更多详细信息，请参阅 Docker Registry HTTP API V2 文档。