14.3. 使用 Red Hat Quay 代理远程 registry
以下流程描述了如何使用 Red Hat Quay 代理远程 registry。此流程设置为 proxy quay.io,它允许用户使用 podman
从 quay.io 上的任何命名空间拉取任何公共镜像。
先决条件
-
config.yaml 中的
FEATURE_PROXY_CACHE
设置为true
。 - 分配 Member 团队角色。如需有关团队角色的更多信息,请参阅 Red Hat Quay 中的用户和机构。
流程
- 在 Red Hat Quay v2 UI 上,单击组织的名称,如 cache-org。
- 在导航窗格中,单击 Settings。
在 Remote Registry 框中,输入要缓存的远程 registry 的名称,如
quay.io
,然后点 Save。注意通过在 远程 Registry 中添加命名空间,例如
quay.io/<namespace
>,您的机构中的用户只能从该命名空间中代理。- 可选。在 Remote Registry username 框中,输入用于向上一步中指定的远程 registry 进行身份验证的用户名。对于上游的匿名拉取,您可以将此留空。如果您在创建时设置用户名,则无法在不删除代理缓存和创建新 registry 的情况下添加用户名。
- 可选。在 Remote registry 密码 框中,输入要在远程 registry 中进行身份验证的密码。对于上游的匿名拉取,您可以将此留空。如果您在创建时设置用户名,则无法在不删除代理缓存和创建新 registry 的情况下添加用户名。
可选。在 Expiration 字段中设置一个时间。
注意- 代理机构中缓存镜像的默认 tag Expiration 字段设置为 86400 秒。在代理机构中,每当拉取标签时,标签过期都会刷新到 UI 的 过期 项中设置的值。此功能与 Quay 的默认 单独标签过期 功能不同。在代理机构中,可以覆盖各个标签功能。发生这种情况时,根据代理机构的过期字段重置单个标签的 过期。
- 过期的镜像将在分配的时间后消失,但仍然存储在 Red Hat Quay 中。镜像被完全删除或收集的时间取决于机构的 Time Machine 设置。垃圾回收的默认时间为 14 天,除非另有指定。
- 可选。如果要使用不安全的协议,请选中 http 框。如果没有选中,则使用 https 来请求远程 registry。
- 点击 Save。
验证
在 CLI 中,从指定的远程 registry (如
quay.io
)拉取公共镜像,充当代理缓存:$ podman pull <registry_url>/<organization_name>/<quayio_namespace>/<image_name>
重要如果您的组织被设置为从远程 registry 的单个命名空间中拉取,则必须在 URL 中省略远程 registry 命名空间。例如,
podman pull <registry_url>/<organization_name>/<image_name>
。
14.3.1. 在代理机构中利用存储配额限制
在 Red Hat Quay 3.8 中,代理缓存功能通过标记的镜像自动运行功能进行了增强。只有经过代理的命名空间配置了配额限制时,才会提供自动镜像标签。目前,如果镜像大小大于组织的配额,则镜像会被跳过,直到管理员创建必要的空间。现在,当推送镜像超过分配的空间时,自动运行增强会标记最早使用的标签来删除。因此,存储了新镜像标签,而使用最少的镜像标签则标记为删除。
- 作为 auto-pruning 功能的一部分,标记为删除的标签最终由垃圾收集器(gc) worker 进程收集垃圾回收。因此,在此期间不会完全强制配额大小限制。
- 目前,命名空间配额大小计算不会考虑 manifest 子大小。这是一个已知问题,它将在以后的 Red Hat Quay 版本中解决。
14.3.1.1. 在代理机构中测试存储配额限制功能
使用以下步骤测试启用了代理缓存和存储配额限制的机构的自动运行功能。
先决条件
- 您的机构被配置为作为代理机构。以下来自 quay.io 的代理示例。
-
FEATURE_PROXY_CACHE
在config.yaml
文件中被设置为true
。 -
FEATURE_QUOTA_MANAGEMENT
在config.yaml
文件中被设置为true
。 -
您的组织配置了配额限制,如
150 MB
。
流程
从代理机构拉取(pull)到您的仓库,例如:
$ podman pull quay-server.example.com/proxytest/projectquay/quay:3.7.9
根据存储库中剩余的空间,您可能需要从代理机构拉取附加镜像,例如:
$ podman pull quay-server.example.com/proxytest/projectquay/quay:3.6.2
在 Red Hat Quay registry UI 中,点存储库的名称。
-
在导航窗格中,单击 Tags,并确保
quay:3.7.9
和quay:3.6.2
已标记。
-
在导航窗格中,单击 Tags,并确保
拉取导致您的存储库超过分配配额的最后镜像,例如:
$ podman pull quay-server.example.com/proxytest/projectquay/quay:3.5.1
-
刷新 Red Hat Quay registry 的 Tags 页面。您推送的第一个镜像,例如
quay:3.7.9
应该已被自动修剪。Tags 页面现在应当显示quay:3.6.2
和quay:3.5.1
。