迹忆客 专注技术分享

几次迭代后，Docker Registry 从版本 1 升级到版本 2。特别是新的，一些命令需要在其官方文档网站上包含或充分记录。

一个示例是获取 Docker Registry 中的图像列表。

本文将讨论获取 Docker Registry V2 中的镜像列表。

在 Docker Registry V2 上获取完整的镜像列表

在我们开始之前，通过运行以下命令在 DockerHub 中拉取最新版本的 Docker Registry。

$ docker pull distribution/registry:master

在 Docker Registry 版本 1 中，我们可以通过对 http://myregistry:5000/v1/search? 的基本 URL 执行 API GET 调用来获取所有图像的列表。 虽然文档中没有暗示，但我们也可以通过调用 GET 请求来执行类似的方法来更新和不同的基本 URL。

列出所有存储库和镜像

当 Docker 将 Docker Registry 更新到版本 2 时，他们还更新了所有 API 基本 URL。 所以现在，我们可以使用下面的 URL，而不是调用 v1 基本 URL。

$ curl -X GET https://myregistry:5000/v2/_catalog

默认结果仅显示一百 (100) 个镜像记录，但如果需要显示更多，可以通过附加查询参数对结果进行分页。

$ curl -X GET https://myregistry:5000/v2/_catalog?n=<count>

列出存储库的所有标签

如果我们需要列出存储库的所有标签，我们可以使用下面的不同端点。

$ curl -X GET https://myregistry:5000/v2/<name>/tags/list

我们可以将名称值替换为我们要从中查询标签的存储库的名称。

使用凭据查询 API

如果注册表需要身份验证，我们必须通过添加 -u 标志在 curl 命令中指定我们的凭据。

$ curl -X GET -u <username>:<password> https://myregistry:5000/v2/_catalog
$ curl -X GET -u <username>:<password> https://myregistry:5000/v2/<name>/tags/list

如果我们的注册表使用自签名证书而不是凭据，我们可以通过添加 -k 和 --insecure 标志来发出不安全的请求。 但是，这被认为是一种安全风险，因此使用它需要您自担风险。

Docker Registry v2 API 提供了更多的端点来满足更多的请求。 我们可以在此链接中找到完整的端点。