第 10 章 组件和功能配置字段
Component 和 Feature Configuration 部分描述了可在各种子系统中微调 Red Hat Quay 的可配置字段。这些字段允许管理员自定义 registry 行为,启用或禁用特定功能,并与外部服务和基础架构集成。虽然基本部署不需要,但这些选项支持与安全性、自动化、可扩展性、合规性和性能相关的高级用例。
10.1. 核心配置概述 复制链接链接已复制到粘贴板!
使用这些核心字段配置 registry 的基本行为,包括主机名、协议、身份验证设置等。
10.1.1. registry 品牌和身份字段 复制链接链接已复制到粘贴板!
以下配置字段允许您修改 Red Hat Quay 部署中显示的品牌、身份和联系信息。使用这些字段,您可以通过指定在 UI 中显示的标题、标头、页脚和机构联系人链接来自定义 registry 如何出现在用户。
Red Hat Quay v2 UI 中不提供以下部分。
字段 | 类型 | 描述 |
---|---|---|
REGISTRY_TITLE | 字符串 |
如果指定,则 registry 的长格式标题。在 Red Hat Quay 部署的前端中显示,例如在机构的登录页面中。不应超过 35 个字符。 |
REGISTRY_TITLE_SHORT | 字符串 |
如果指定,则 registry 的短格式标题。标题显示在您的机构各个页面中,例如,作为您所在机构的 教程 页面上的标题。 |
CONTACT_INFO | String 数组 | 如果指定,在联系页面中要显示的联系信息。如果只指定了单一联系人信息,联系页脚将直接链接。 |
[0] | 字符串 |
添加发送电子邮件的链接。 |
[1] | 字符串 |
添加访问 IRC chat room 的链接。 |
[2] | 字符串 |
添加链接来调用电话号码。 |
[3] | 字符串 |
添加指向定义的 URL 的链接。 |
字段 | 类型 | 描述 |
---|---|---|
品牌 | 对象 | Red Hat Quay UI 中的徽标和 URL 的自定义品牌。 |
.logo | 字符串 |
主徽标镜像 URL。
标头徽标默认为 205x30 PX。Web UI 的屏幕上的 Red Hat Quay 登录表格徽标默认为 356.5x39.7 PX。 |
.footer_img | 字符串 |
UI footer 的徽标。默认为 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
10.1.2. SSL/TLS 配置字段 复制链接链接已复制到粘贴板!
本节论述了在 Red Hat Quay 部署中启用和管理 SSL/TLS 加密的可用配置字段。
字段 | 类型 | 描述 |
---|---|---|
PREFERRED_URL_SCHEME | 字符串 |
|
SERVER_HOSTNAME | 字符串 |
Red Hat Quay 可访问的 URL,没有方案 |
SSL_CIPHERS | String 数组 |
如果指定了,用于启用和禁用的 SSL 密码的 nginx 定义列表 |
SSL_PROTOCOLS | String 数组 |
如果指定,则 nginx 配置为启用列表中定义的 SSL 协议列表。从列表中删除 SSL 协议会禁用 Red Hat Quay 启动过程中的协议。 |
SESSION_COOKIE_SECURE | 布尔值 |
是否应在会话 Cookie 上设置 |
EXTERNAL_TLS_TERMINATION | 布尔值 |
如果支持 TLS,则设置为 |
SSL 配置示例 YAML
10.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
# ...
10.1.4. 日志记录和调试变量 复制链接链接已复制到粘贴板!
以下变量控制 Red Hat Quay 日志事件、公开调试信息并与系统健康检查进行交互。这些设置对于对 registry 的故障排除和监控很有用
变量 | 类型 | 描述 |
---|---|---|
DEBUGLOG | 布尔值 | 是否启用或禁用调试日志。 |
用户_DEBUG |
整数. |
用于在明文中调试 LDAP 操作,包括密码。必须与 重要
设置 |
ALLOW_PULLS_WITHOUT_STRICT_LOGGING | 布尔值 |
如果为 true,则即使无法写入拉取审计日志条目,拉取仍会成功。如果数据库处于只读状态,且需要拉取以便在那个时间内继续,则这非常有用。 |
ENABLE_HEALTH_DEBUG_SECRET | 字符串 | 如果指定,可提供给健康端点的 secret,以便在不以超级用户身份验证时查看完整的调试信息 |
HEALTH_CHECKER | 字符串 |
配置的健康检查 |
FEATURE_AGGREGATED_LOG_COUNT_RETRIEVAL | 布尔值 |
是否允许检索聚合的日志计数 |
日志记录和调试示例 YAML
其他资源
10.1.5. registry 状态和系统行为配置字段 复制链接链接已复制到粘贴板!
以下配置字段控制 Red Hat Quay registry 的操作状态及其如何与外部系统交互。这些设置允许管理员将 registry 置于受限只读模式下进行维护,并通过阻止 webhook 的目标特定主机名来强制实施额外的安全性。
字段 | 类型 | 描述 |
---|---|---|
REGISTRY_STATE | 字符串 |
registry 的状态 |
WEBHOOK_HOSTNAME_BLACKLIST | String 数组 | 在除 localhost 外验证时,从 Webhook 中禁止的主机名集合 |
registry 状态和系统行为示例 YAML