Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

Red Hat Quay 发行注记

Red Hat Quay 3.14

Red Hat Quay

Red Hat OpenShift Documentation Team

摘要

Red Hat Quay 发行注记

前言

Red Hat Quay 容器 registry 平台在任何基础架构上提供安全存储、分发和管理容器和云原生工件。它作为独立组件或 OpenShift Container Platform 上的 Operator 提供。Red Hat Quay 包括以下功能和优点：

  • 细粒度安全管理
  • 任何规模的快速可靠的
  • 高速度 CI/CD
  • 自动化安装和更新
  • 企业验证和基于团队的访问控制
  • OpenShift Container Platform 集成

Red Hat Quay 定期发布，包括新功能、错误修复和软件更新。要为独立和 OpenShift Container Platform 部署 升级 Red Hat Quay，请参阅升级 Red Hat Quay。

重要

Red Hat Quay 只支持回滚到或降级到以前的 z-stream 版本，如 3.13.2 → 3.13.1。不支持回滚到之前的 y-stream 版本(3.14 → 3.13)。这是因为 Red Hat Quay 更新可能包含升级到 Red Hat Quay 的新版本时应用的数据库架构升级。数据库架构升级不被视为向后兼容。

基于 Operator 的部署或基于虚拟机的部署不支持降级到以前的 z-streams。只有在极端情况下才应进行降级。回滚 Red Hat Quay 部署的决定必须与 Red Hat Quay 支持和开发团队结合使用。如需更多信息，请联系红帽 Quay 支持。

Red Hat Quay 文档包括了每个发行版本的版本。最新的 Red Hat Quay 文档包括在 Red Hat Quay Documentation 页面中。目前，版本 3 是最新的主版本。

注意

在版本 2.9.2 之前，Red Hat Quay 称为 Quay Enterprise。2.9.2 及之前的版本的文档在 Red Hat Quay 2.9 页面的产品文档中存档。

第 1 章 Red Hat Quay 发行注记

以下小节详细介绍了 y 和 z 流发行版本信息。

1.1. RHBA-2024:8408 - Red Hat Quay 3.14.0 发行版本

2025 年 4 月 2 日

Red Hat Quay 版本 3.14 现在包括在 Clair 4.8 中。此更新包括的程序错误修正信息包括在 RHBA-2025:2467 公告中。有关最新兼容性列表，请参阅 Quay Enterprise 3.x Tested Integrations。有关 Red Hat Quay 发行节奏的信息，请参阅 Red Hat Quay 生命周期政策。

1.2. Red Hat Quay 文档更改

Red Hat Quay 3.14 发行版本中进行了以下文档更改：

  • Red Hat Quay API 指南已更新并分成两个图书：

    • Red Hat Quay API 指南。本书包含 Red Hat Quay API 概述、令牌类型概述(OAuth 2.0 访问令牌、机器人帐户令牌和 OCI 引用器 OAuth 访问令牌)，如何启用和使用 Red Hat Quay API、令牌管理建议，以及利用 API 端点执行命令的示例命令。如果您熟悉 Red Hat Quay API，或想要了解其令牌类型以及如何利用 API，则本书很有用。
    • Red Hat Quay API 参考。本书包含所有 API 参考端点，以及这些端点附带的示例命令。如果您已熟悉使用 Red Hat Quay API，则本书很有用。

1.3. Red Hat Quay 的新功能和增强

对 Red Hat Quay 进行了以下更新。

1.3.1. Clair 的改进

在这个版本中，Clair 索引器数据包含在下游构建中。这允许 Red Hat Quay 管理员在 air-gapped 或断开连接的环境中运行 Clair 时更轻松地引用 clair-config.yaml 文件中的索引器。

如需更多信息，请参阅 在断开连接的环境中的 Clair。

1.3.2. 在 v2 UI 上呈现模型卡

随着 Red Hat Quay 3.14 的发布，v2 UI 现在会为包含模型卡的机器学习模型呈现模型卡信息。当清单具有特定的注解（例如 application/x-mlmodel）和存储在清单中的层的模型卡时，标签信息页面中会显示一个 Model Card 选项卡。Model Card 页面的信息为用户提供了对每个模型的全面见解，帮助用户加强对 registry 中存储的模型的了解。

注意

Model Card rendered 页面仅适用于 Red Hat Quay v2 UI。

要查看模型卡信息，Red Hat Quay 用户或管理员必须将工件推送到存储库。工件必须具有附带的模型卡。此信息在 Repository → < tag_name > → Model Card 下显示。

如需更多信息，请参阅使用 v2 UI 查看模型卡信息。

1.3.3. 标签过期增强

在以前的版本中，当为 Red Hat Quay 配置标签过期时，Red Hat Quay v2 UI 中无法使用 yearly 选项。在这个版本中，用户可以在 Red Hat Quay v2 UI 中配置默认标签过期时间。这可以通过使用 Red Hat Quay UI 或 config.yaml 文件来设置。例如： 

DEFAULT_TAG_EXPIRATION: 1y
TAG_EXPIRATION_OPTIONS:
  - 1y

1.4. Red Hat Quay 配置字段更新和更改

以下配置字段已添加到 Red Hat Quay 3.14 中。

1.4.1. 模型卡渲染配置字段

在 Red Hat Quay v2 UI 中为模型卡渲染功能添加了以下配置字段：

字段类型描述

FEATURE_UI_MODELCARD

布尔值

在 UI 中启用 Modelcard image 选项卡。默认值为 true。

UI_MODELCARD_ARTIFACT_TYPE

字符串

定义 modelcard 工件类型。

UI_MODELCARD_ANNOTATION

对象

此可选字段定义存储在 OCI 镜像中的模型卡的层注解。

UI_MODELCARD_LAYER_ANNOTATION

对象

此可选字段定义存储在 OCI 镜像中的模型卡的层注解。

这些配置字段在 config.yaml 文件中默认启用和设置：

模型卡 YAML 示例

FEATURE_UI_MODELCARD: true
UI_MODELCARD_ARTIFACT_TYPE: application/x-mlmodel
UI_MODELCARD_ANNOTATION:
  org.opencontainers.image.description: "Model card metadata"
UI_MODELCARD_LAYER_ANNOTATION:
  org.opencontainers.image.title: README.md

如需更多信息，请参阅使用 v2 UI 查看模型卡信息。

1.4.2. IGNORE_UNKNOWN_MEDIATYPES 配置字段删除

IGNORE_UNKNOWN_MEDIATYPES 配置字段已被删除。默认情况下，Red Hat Quay 接受所有工件类型。

1.5. API 端点增强

Red Hat Quay 3.14 中不会添加新的 API 端点。

1.6. Red Hat Quay 3.14 已知问题和限制

以下小节记录了 Red Hat Quay 3.14 的已知问题和限制。

1.6.1. 不支持的镜像类型处于查询状态

将不支持的镜像类型（如 AI 模型）推送到 Red Hat Quay registry 时，UI 上的 Security Report 和 Packages 页面将无法加载。这是因为这些镜像类型会一直处于 Querying 状态，因此这些标签页的页面会留空。这是一个已知问题，并将在以后的 Red Hat Quay 版本中解决。

1.6.2. OpenShift Container Platform 多个入口控制器上的 Red Hat Quay 已知问题

在定义了多个入口控制器的 OpenShift Container Platform 集群中，Red Hat Quay Operator 会迭代可用的入口控制器列表，它会使用它遇到的第一个决定集群主机名。但是，在此列表中的 ingress 控制器的顺序无法保证在协调周期内保持一致。因此，Operator 可能会选择不同的入口控制器，从而导致它检测到集群主机名的更改并启动新的协调过程。这可能会导致 OpenShift Container Platform 部署中的 quay pod 和 Red Hat Quay 不稳定。

使用以下方法之一避免这个问题：

  • 将 QuayRegistry 资源的 路由和 tls 组件设置为 unmanaged (managed: false)，并为 Red Hat Quay 创建自定义 Route。有关创建自定义路由的更多信息，请参阅禁用 Route 组件。
  • 确保只有一个入口控制器与 Red Hat Quay 路由资源 匹配，这些资源可通过入口控制器分片完成。如需更多信息，请参阅 OpenShift Container Platform 中的 Ingress 分片。

1.7. Red Hat Quay 程序错误修复

Red Hat Quay 3.14 中解决了以下问题：

  • PROJQUAY-8532.在以前的版本中，当使用 Amazon Web Services (AWS) Relational Database Service (RDS)从版本 12.19 升级到 15.7 时，更新 Clair 时存在问题。升级后，扫描新镜像会导致镜像处于 Queued 状态，且无法处理错误报告。这个问题已解决。
  • PROJQUAY-8131.在以前的版本中，当尝试在引用的端点上尝试序列化清单类型时，用户可以收到未知的异常。这会导致以下错误： 类型为 Manifest 的 Object is not JSON serializable。这个问题已解决。
  • PROJQUAY-8272.在以前的版本中，嵌套索引或引用另一个索引的tex 在 Red Hat Quay 中无法正常工作。当推送到 registry 时，这会产生以下响应： Error response from registry: identifyable error message not found: PUT "https://quay.io/v2/arewm/oci-spec-1217/manifests/nested-index": response status code 500: Internal Server Error。这个问题已解决。
  • PROJQUAY-8559.在以前的版本中，NGINX 日志中的一个 passport 字段不会被模糊处理。这个问题已被解决，repeatPassword 值会被隐藏。

1.8. Red Hat Quay 功能跟踪器

Red Hat Quay 添加了新的功能，其中的一些功能当前还只是一个技术预览。技术预览功能是实验性功能，不适用于生产环境。

之前版本中的一些功能已被弃用或删除。弃用的功能仍然包含在 Red Hat Quay 中，但计划在以后的发行版本中删除，且不建议在新的部署中使用。有关 Red Hat Quay 中已弃用和删除的功能的最新列表，请参阅表 1.1。表后列出了更详细的、已弃用和删除的功能信息。

表 1.1. tracker 的新功能
功能Quay 3.14Quay 3.13Quay 3.12

使用 v2 UI 查看模型卡信息。

公开发行

-

-

使用机器人帐户进行无密钥身份验证

公开发行

公开发行

-

Red Hat Quay 和 SQL 之间的基于证书的身份验证

公开发行

公开发行

-

Splunk HTTP 事件收集器(HEC) 支持

公开发行

公开发行

公开发行

开放容器项目 1.1 支持

公开发行

公开发行

公开发行

重新分配 OAuth 访问令牌

公开发行

公开发行

公开发行

创建镜像过期通知

公开发行

公开发行

公开发行

FEATURE_UI_V2

技术预览

技术预览

技术预览

1.8.1. IBM Power、IBM Z 和 IBM® LinuxONE 支持列表

表 1.2. 支持和不支持的功能列表
功能IBM PowerIBM Z 和 IBM® LinuxONE

允许通过 Azure 上的 OIDC 进行团队同步

不支持

不支持

在独立部署中备份和恢复

支持

支持

Clair disconnected

支持

支持

geo-Replication （独立）

支持

支持

geo-Replication (Operator)

支持

不支持

IPv6

不支持

不支持

将独立迁移到 Operator 部署

支持

支持

镜像 registry

支持

支持

Quay 配置编辑器 - 镜像, OIDC

支持

支持

Quay 配置编辑器 - MAG, Kinesis, Keystone, GitHub Enterprise

不支持

不支持

Quay 配置编辑器 - Red Hat Quay V2 用户界面

支持

支持

Quay disconnected

支持

支持

仓库镜像

支持

支持

法律通告

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat, Inc.