12.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 中的用户和机构。

流程

  1. 在 UI 上的 Quay 机构中，例如 cache-quayio，单击左侧窗格的 Organization Settings。

  2. 可选：点 Add Storage Quota 为您的机构配置配额管理。有关配额管理的更多信息，请参阅 配额管理。

    注意

    在某些情况下，当拉取过程中达到配额限制时，使用 Podman 拉取镜像可能会返回以下错误： 无法拉取 image: Error parsing image configuration: Error fetching blob: invalid status code from registry 403(Forbidden)。错误 403 is inaccurate，且发生时，Podman 隐藏了正确的 API 错误： Quota been exceeded on namespace。已知的问题将在以后的 Podman 更新中修复。

  3. 在 Remote Registry 中，输入要缓存的远程 registry 的名称，如 quay.io，然后单击 Save。

    注意

    通过在 远程 Registry 中添加命名空间，例如 quay.io/<namespace >，您的机构中的用户只能从该命名空间中代理。

  4. 可选：添加 远程 Registry 用户名和 远程 Registry 密码。

    注意

    如果您没有设置 Remote Registry Username 和 Remote Registry Password，则无法在不删除代理缓存的情况下添加一个，并创建新的 registry。

  5. 可选：在 过期 项中设置时间。

    注意
    • 代理机构中缓存镜像的默认 tag Expiration 字段设置为 86400 秒。在代理机构中，每当拉取标签时，标签过期都会刷新到 UI 的 过期 项中设置的值。此功能与 Quay 的默认 单独标签过期 功能不同。在代理机构中，可以覆盖各个标签功能。发生这种情况时，根据代理机构的过期字段重置单个标签的 过期。
    • 过期的镜像将在分配的时间后消失，但仍存储在 Quay 中。镜像被完全删除或收集的时间取决于机构的 Time Machine 设置。垃圾回收的默认时间为 14 天，除非另有指定。
  6. 点击 Save。

  7. 在 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>。

12.3.1. 在代理机构中利用存储配额限制

在 Red Hat Quay 3.8 中，代理缓存功能通过标记的镜像自动运行功能进行了增强。只有经过代理的命名空间配置了配额限制时，才会提供自动镜像标签。目前，如果镜像大小大于组织的配额，则镜像会被跳过，直到管理员创建必要的空间。现在，当推送镜像超过分配的空间时，自动运行增强会标记最早使用的标签来删除。因此，存储了新镜像标签，而使用最少的镜像标签则标记为删除。

重要
  • 作为 auto-pruning 功能的一部分，标记为删除的标签最终由垃圾收集器(gc) worker 进程收集垃圾回收。因此，在此期间不会完全强制配额大小限制。
  • 目前，命名空间配额大小计算不会考虑 manifest 子大小。这是一个已知问题，它将在以后的 Red Hat Quay 版本中解决。

12.3.1.1. 在代理机构中测试存储配额限制功能

使用以下步骤测试启用了代理缓存和存储配额限制的机构的自动运行功能。

先决条件

  • 您的机构被配置为作为代理机构。以下来自 quay.io 的代理示例。
  • FEATURE_PROXY_CACHE 在 config.yaml 文件中被设置为 true。
  • FEATURE_QUOTA_MANAGEMENT 在 config.yaml 文件中被设置为 true。
  • 您的组织配置了配额限制，如 150 MB。

流程

  1. 从代理机构拉取(pull)到您的仓库，例如： 

    $ podman pull quay-server.example.com/proxytest/projectquay/quay:3.7.9

  2. 根据存储库中剩余的空间，您可能需要从代理机构拉取附加镜像，例如： 

    $ podman pull quay-server.example.com/proxytest/projectquay/quay:3.6.2

  3. 在 Red Hat Quay registry UI 中，点存储库的名称。

    • 在导航窗格中，单击 Tags，并确保 quay:3.7.9 和 quay:3.6.2 已标记。

  4. 拉取导致您的存储库超过分配配额的最后镜像，例如： 

    $ podman pull quay-server.example.com/proxytest/projectquay/quay:3.5.1
  5. 刷新 Red Hat Quay registry 的 Tags 页面。您推送的第一个镜像，例如 quay:3.7.9 应该已被自动修剪。Tags 页面现在应当显示 quay:3.6.2 和 quay:3.5.1。