搜索

12.3. 使用 Red Hat Quay 代理远程 registry

download PDF

以下流程描述了如何使用 Red Hat Quay 代理远程 registry。此流程设置为代理 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 拉取镜像可能会返回以下错误: Error parsing image configuration: Error fetch blob: invalid status code from registry 403 (Forbidden)。错误 403 isaccurate 发生,因为 Podman 在命名空间上隐藏了正确的 API 错误: 配额已超过命名空间。此已知问题将在以后的 Podman 更新中解决。

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

    注意

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

  4. 可选:添加 远程 Registry UsernameRemote Registry 密码

    注意

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

  5. 可选:在 Expiration 字段中设置一个时间。

    注意
    • 代理机构中缓存的镜像的默认标签 Expiration 字段被设置为 86400 秒。在代理机构中,每次拉取标签时,标签过期都会刷新到 UI 的 Expiration 字段中设置的值。此功能与 Quay 的默认 单个标签过期 功能不同。在代理机构中,可以覆盖单个标签功能。发生这种情况时,根据代理机构的 Expiration 字段重置各个标签的过期时间。
    • 过期的镜像将在分配的时间后消失,但仍然存储在 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 进程收集垃圾回收。因此,在此期间不会完全强制实施配额大小限制。
  • 目前,命名空间配额大小计算不会考虑清单子的大小。这是一个已知问题,并将在以后的 Red Hat Quay 版本中解决。

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

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

先决条件

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

流程

  1. 从代理机构拉取镜像到存储库,例如:

    $ 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 中,点存储库的名称。

    • 点导航窗格中的标签,并确保 quay:3.7.9quay: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.2quay:3.5.1
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.