第 9 章 组件和功能配置字段
Component 和 Feature Configuration 部分描述了可在各种子系统中微调 Red Hat Quay 的可配置字段。这些字段允许管理员自定义 registry 行为,启用或禁用特定功能,并与外部服务和基础架构集成。虽然基本部署不需要,但这些选项支持与安全性、自动化、可扩展性、合规性和性能相关的高级用例。
9.1. 核心配置概述 复制链接链接已复制到粘贴板!
使用这些核心字段配置 registry 的基本行为,包括主机名、协议、身份验证设置等。
9.1.1. registry 品牌和身份字段 复制链接链接已复制到粘贴板!
以下配置字段允许您修改 Red Hat Quay 部署中显示的品牌、身份和联系信息。使用这些字段,您可以通过指定在 UI 中显示的标题、标头、页脚和机构联系人链接来自定义 registry 如何出现在用户。
Red Hat Quay v2 UI 中不提供以下部分。
字段 | 类型 | 描述 |
---|---|---|
REGISTRY_TITLE | 字符串 |
如果指定,registry 的长格式标题。显示在 Red Hat Quay 部署的前端中,例如,位于您机构的登录页面中。不应超过 35 个字符。 |
REGISTRY_TITLE_SHORT | 字符串 |
如果指定,registry 的简短格式标题。title 显示在您的机构的不同页面上,例如,作为您组织的 教程 标题。 |
CONTACT_INFO | 字符串数组 | 如果指定,要在联系页面上显示联系信息。如果只指定了单个联系信息,请联系页脚将直接链接。 |
[0] | 字符串 |
添加用于发送电子邮件的链接。 |
[1] | 字符串 |
添加访问 IRC 聊天房的链接。 |
[2] | 字符串 |
添加一个链接以调用电话号码。 |
[3] | 字符串 |
添加指向定义的 URL 的链接。 |
字段 | 类型 | 描述 |
---|---|---|
品牌 | 对象 | 在 Red Hat Quay UI 中自定义徽标和 URL 的品牌。 |
.logo | 字符串 |
主徽标图像 URL.
标头徽标默认为 205x30 PX。Web UI 的屏幕中的 Red Hat Quay 符号上的表单徽标默认为 356.5x39.7 PX。 |
.footer_img | 字符串 |
UI 页徽标.默认为 144x34 PX. |
.footer_url | 字符串 |
footer 镜像的链接。 |
字段 | 类型 | 描述 |
---|---|---|
FOOTER_LINKS | 对象 | 在 Red Hat Quay 的 UI 中启用自定义页脚链接以进行以前的安装。 |
.TERMS_OF_SERVICE_URL | 字符串 |
用于 on-prem 安装的自定义服务术语。 |
.PRIVACY_POLICY_URL | 字符串 |
用于 on-prem 安装的自定义隐私策略。 |
.SECURITY_URL | 字符串 |
用于 on-prem 安装的自定义安全页面。 |
.ABOUT_URL | 字符串 |
针对 on-prem 安装的自定义页。 |
registry 品牌和身份示例 YAML
9.1.2. SSL/TLS 配置字段 复制链接链接已复制到粘贴板!
本节论述了在 Red Hat Quay 部署中启用和管理 SSL/TLS 加密的可用配置字段。
字段 | 类型 | 描述 |
---|---|---|
PREFERRED_URL_SCHEME | 字符串 |
|
SERVER_HOSTNAME | 字符串 |
可以访问 Red Hat Quay 的 URL,不包括网络协议。 |
SSL_CIPHERS | 字符串数组 |
如果指定,则要启用和禁用的 nginx 定义的 SSL 密码列表 |
SSL_PROTOCOLS | 字符串数组 |
如果指定了,nginx 被配置为启用列表中定义的 SSL 协议列表。从列表中删除 SSL 协议会禁用 Red Hat Quay 启动期间的协议。 |
SESSION_COOKIE_SECURE | 布尔值 |
对于使用 SSL 的所有安装,是否应在会话 Cookie 上设置 |
EXTERNAL_TLS_TERMINATION | 布尔值 |
如果支持 TLS,则设置为 |
SSL 配置示例 YAML
9.1.3. IPv6 配置字段 复制链接链接已复制到粘贴板!
您可以使用 FEATURE_LISTEN_IP_VERSION
配置字段来指定 Red Hat Quay 应该侦听的 IP 协议系列:IPv4、IPv6 或两者(dual-stack)。在 registry 必须在 IPv6 或双栈网络上运行时,此字段至关重要。
字段 | 类型 | 描述 |
---|---|---|
FEATURE_LISTEN_IP_VERSION | 字符串 |
启用 IPv4、IPv6 或双栈协议系列。必须正确设置此配置字段,否则 Red Hat Quay 无法启动。默认: |
IPv6 示例 YAML
# ... FEATURE_LISTEN_IP_VERSION: dual-stack # ...
# ...
FEATURE_LISTEN_IP_VERSION: dual-stack
# ...
9.1.4. 日志记录和调试变量 复制链接链接已复制到粘贴板!
以下变量控制 Red Hat Quay 日志事件、公开调试信息并与系统健康检查进行交互。这些设置对于对 registry 的故障排除和监控很有用
变量 | 类型 | 描述 |
---|---|---|
DEBUGLOG | 布尔值 | 是否启用或禁用调试日志。 |
USERS_DEBUG |
整数. |
用于以明文中调试 LDAP 操作,包括密码。必须与 重要
设置 |
ALLOW_PULLS_WITHOUT_STRICT_LOGGING | 布尔值 |
如果为 true,则拉取仍然会成功,即使无法写入 pull audit 日志条目。如果数据库处于只读状态,并且需要在此时间段内拉取以继续,这非常有用。 |
ENABLE_HEALTH_DEBUG_SECRET | 字符串 | 如果指定,可以授予健康端点的 secret,以便在未作为超级用户验证时查看完整的调试信息 |
HEALTH_CHECKER | 字符串 |
配置的健康检查 |
FEATURE_AGGREGATED_LOG_COUNT_RETRIEVAL | 布尔值 |
是否允许检索聚合日志计数 |
日志记录和调试示例 YAML
其他资源
9.1.5. registry 状态和系统行为配置字段 复制链接链接已复制到粘贴板!
以下配置字段控制 Red Hat Quay registry 的操作状态及其如何与外部系统交互。这些设置允许管理员将 registry 置于受限只读模式下进行维护,并通过阻止 webhook 的目标特定主机名来强制实施额外的安全性。
字段 | 类型 | 描述 |
---|---|---|
REGISTRY_STATE | 字符串 |
registry 的状态 |
WEBHOOK_HOSTNAME_BLACKLIST | 字符串数组 | 验证超过 localhost 时禁止 Webhook 中的主机名集合 |
registry 状态和系统行为示例 YAML