第 1 章 配置入门
Red Hat Quay 可以作为独立部署,或使用 Operator 部署到现有的 OpenShift 集群上。您用来创建、检索、更新和验证 Red Hat Quay 配置的方法稍有不同,具体取决于您使用的部署类型。但是,核心配置选项对于所有类型的部署都基本相同,可以操作这些选项:
-
通过编辑 config.yaml 文件直接编辑
config.yaml
文件。请参阅 编辑配置文件 的部分。 - 以编程方式使用配置 API。请参阅使用 配置 API 的部分。
- 在视觉上,使用配置工具 UI。请参阅使用 配置工具 的部分。
您可以使用 Operator 在 OpenShift 上安装 Quay,而无需提供任何初始配置,因为 Operator 提供了不合理的默认值来部署 registry。但是,对于独立部署,您必须提供最小配置级别,然后才能启动 registry。最小的要求可以使用 配置 API 来决定,并记录在 部分
使用初始配置部署 Quay 后,您应该从正在运行的系统中检索并保存完整的配置,因为它可能包含额外的、生成值,在重新启动或升级系统时,您会在未来需要用到的值。
1.1. Quay 3.6 的配置更新
1.1.1. 新配置字段
-
FEATURE_EXTENDED_REPOSITORY_NAMES: 支持嵌套存储库和扩展仓库名称。此更改允许使用某些 OpenShift Container Platform 用例所需的存储库名称
/
。如需更多信息,请参阅配置嵌套软件仓库 -
FEATURE_USER_INITIALIZE: 如果设置为 true,可以通过 API
/api/v1/user/initialize
创建第一个用户帐户。如需更多信息,请参阅 预配置 Quay 实现自动化 -
ALLOWED_OCI_ARTIFACT_TYPES: Helm、cosign 和 ztsd 压缩方案工件默认构建在 Red Hat Quay 3.6 中。对于默认不支持的任何其他 OCI 介质类型,您可以将它们添加到 Quay
config.yaml
中的ALLOWED_OCI_ARTIFACT_TYPES
配置中,如需更多信息,请参阅 将其他 OCI 介质类型添加到 Quay中 -
CREATE_PRIVATE_REPO_ON_PUSH: Registry 用户现在在其 config.yaml 中将
CREATE_PRIVATE_REPO_ON_PUSH
设置为True
或False
。 - CREATE_NAMESPACE_ON_PUSH: 现在可被配置为自动创建该机构。
1.1.2. 弃用的配置字段
-
FEATURE_HELM_OCI_SUPPORT: 这个选项已弃用,并将在以后的 Red Hat Quay 版本中删除。在 Red Hat Quay 3.6 中,默认支持 Helm 工件,并包括在
FEATURE_GENERAL_OCI_SUPPORT
属性中。用户不再需要更新其 config.yaml 文件来启用支持。