配置 Red Hat Quay

AUTHENTICATION_TYPE
（必需）

字符串

用于凭证身份验证的身份验证引擎。

值：
of Database,LDAP,JWT,Keystone,OIDC

Default: Database

PREFERRED_URL_SCHEME
（必需）

字符串

访问 Red Hat Quay 时使用的 URL 方案。

值：
of http,https

Default: http

SERVER_HOSTNAME
（必需）

字符串

Red Hat Quay 可访问的 URL，没有方案。

quay-server.example.com

DATABASE_SECRET_KEY
（必需）

字符串

用于加密数据库中敏感字段的密钥。设定后永远不会更改这个值，否则所有依赖字段（如存储库镜像用户名和密码配置）都无效。
这个值由 Red Hat Quay Operator for Operator 部署自动设置。对于独立部署，管理员可以使用 Open SSL 或类似的工具提供自己的密钥。密钥长度不应超过 63 个字符。

SECRET_KEY
（必需）

字符串

用于加密会话 Cookie 和用于正确解释用户会话所需的 CSRF 令牌的密钥。设置时不应更改该值。应该在所有 Red Hat Quay 实例中保留。如果没有在所有实例间持久保留，则可能会出现与会话持久性相关的登录失败和其他错误。

SETUP_COMPLETE
（必需）

布尔值

这是软件早期版本中保留的工件，目前 必须使用 true 值指定。

FEATURE_GARBAGE_COLLECTION

布尔值

是否启用存储库垃圾回收。

Default: True

TAG_EXPIRATION_OPTIONS
（必需）

字符串数组

如果启用，用户可以选择在其命名空间中过期标签的选项。

Pattern:
^[0-9]+(y|w|m|d|h|s)$

DEFAULT_TAG_EXPIRATION
（必需）

字符串

默认可配置标签过期时间。

Pattern:
^[0-9]+(w|m|d|h|s)$
Default: 2w

FEATURE_CHANGE_TAG_EXPIRATION

布尔值

用户和机构是否允许更改其命名空间中标签的标签过期。

Default: True

FEATURE_AUTO_PRUNE

布尔值

当设置为 True 时，启用与自动运行标签相关的功能。
Default: False

NOTIFICATION_TASK_RUN_MINIMUM_INTERVAL_MINUTES

整数

间隔（以分钟为单位），定义过期镜像重新运行通知的频率。

默认为 300

DEFAULT_NAMESPACE_AUTOPRUNE_POLICY

对象

默认机构范围的自动修剪策略。

    .method: number_of_tags

对象

选项指定要保留的标签数的选项。

    .value: <integer>

整数

与 方法一起使用时： number_of_tags，表示要保留的标签数。

例如，若要保留两个标签，请指定 2。

    .creation_date

对象

选项指定保留标签的持续时间。

    .value: <integer>

整数

与 creation_date 一起使用时，表示保留标签的时间。

可以设置为秒(s)、天(d)、月(m)、周(w)或 years (y)。必须包含有效的整数。例如，若要保留一年的标签，请指定 1y。

AUTO_PRUNING_DEFAULT_POLICY_POLL_PERIOD

整数

自动修剪 worker 在 registry 级别运行的时间。默认情况下，它被设置为每天运行一次（每 24 小时一次）。值必须以秒为单位。

FEATURE_QUOTA_MANAGEMENT

布尔值

为配额管理功能启用配置、缓存和验证。

**Default:** `False`

DEFAULT_SYSTEM_REJECT_QUOTA_BYTES

字符串

为所有机构启用系统默认配额拒绝字节允许。

默认情况下，不会设置限制。

QUOTA_BACKFILL

布尔值

启用配额回填工作程序来计算预先存在的 Blob 的大小。

默认:True

QUOTA_TOTAL_DELAY_SECONDS

字符串

启动配额回填的时间延迟。滚动部署可能会导致总部署不正确。此字段 必须设置为 超过滚动部署完成所需的时间。

默认 ：1800

PERMANENTLY_DELETE_TAGS

布尔值

启用与从时间窗中删除标签相关的功能。

默认 ：False

RESET_CHILD_MANIFEST_EXPIRATION

布尔值

重置以子清单为目标的临时标签的过期。将这个功能设置为 True 时，子清单会立即收集垃圾回收。

默认 ：False

FEATURE_PROXY_CACHE

布尔值

使 Red Hat Quay 能够通过上游 registry 的缓存作为拉取(pull)。

默认 ：false

ROBOTS_DISALLOW

布尔值

当设置为 true 时，机器人帐户将阻止所有交互，以及创建
Default:False

REGISTRY_TITLE

字符串

如果指定，则 registry 的长格式标题。在 Red Hat Quay 部署的前端中显示，例如在机构的登录页面中。不应超过 35 个字符。
默认：
Red Hat Quay

REGISTRY_TITLE_SHORT

字符串

如果指定，则 registry 的短格式标题。标题显示在您的机构各个页面中，例如，作为您所在机构的 教程 页面上的标题。
默认：
Red Hat Quay

CONTACT_INFO

String 数组

如果指定，在联系页面中要显示的联系信息。如果只指定了单一联系人信息，联系页脚将直接链接。

[0]

字符串

添加发送电子邮件的链接。

Pattern:
^mailto: (.)+$
Example:
mailto:support@quay.io

[1]

字符串

添加访问 IRC chat room 的链接。

Pattern:
^irc://(.)+$
Example:
irc://chat.freenode.net:6665/quay

[2]

字符串

添加链接来调用电话号码。

Pattern:
^tel: (.)+$
示例：
tel:+1-888-930-3475

[3]

字符串

添加指向定义的 URL 的链接。

Pattern:
^http (s)?://(.)+$
Example:
https://twitter.com/quayio

PREFERRED_URL_SCHEME

字符串

http 或 https 中的一个。请注意，用户只有在客户端到 Quay 的通信路径中没有 TLS 加密时，用户只能将其 PREFERRED_URL_SCHEME 设置为 http。
在使用 TLS 终止负载均衡器、反向代理（如 Nginx）或者使用带有自定义 SSL 证书的 Quay 时，用户必须将其 PREFERRED_URL_SCHEME' 设置为 'https。在大多数情况下，PREFERRED_URL_SCHEME 应该为 https。
默认： http

SERVER_HOSTNAME
（必需）

字符串

Red Hat Quay 可访问的 URL，没有方案

示例：
quay-server.example.com

SSL_CIPHERS

String 数组

如果指定了，用于启用和禁用的 SSL 密码的 nginx 定义列表

示例：
[ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-GCM-SHA384, DHE-RSA-AES128-GCM-SHA256,DHE-DSS-AES128-GCM-SHA256,kEDH+AESGCM,ECDHE-RSA-AES128-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA, ECDHE-ECDSA-AES128-SHA,ECDHE-RSA-aes256-SHA384,ECDHE-ECDSA-aes256-SHA384, ECDHE-RSA-aes256-SHA,ECDHE-ECDSA-aes256-SHA,DHE-RSA-aes128-SHA256,DHE-RSA-aes128-SHA, , DHE-DSS-aes128-SHA256,DHE-RSA-aes256-SHA256 , DHE-DSS-aes256-SHA ,DHE-DSS-aes256-SHA, aes128-GCM-sha256, aes256-GCM-SHA 384 , aes128-SHA256 , aes128-SHA256, aes128-GCM-sha256 , aes256-GCM- SHA256, AES256-SHA256,AES128-SHA,AES256-SHA,AES,!3DES", !aNULL,!eNULL,!EXPORT,DES,!RC4, MD5 ,MD5, !PSK,!aECDH,!EDH-DSS-DES-CBC3-SHA,!EDH-RSA-DES-CBC3-SHA,!KRB5-DES-CBC3-SHA]

SSL_PROTOCOLS

String 数组

如果指定，则 nginx 配置为启用列表中定义的 SSL 协议列表。从列表中删除 SSL 协议会禁用 Red Hat Quay 启动过程中的协议。

Example:
['TLSv1','TLSv1.1','TLSv1.2', 'TLSv1.3]'

SESSION_COOKIE_SECURE

布尔值

是否应在会话 Cookie 上设置 secure 属性

Default:
False

Recommendation:
Set to True

AUTHENTICATION_TYPE
（必需）

字符串

必须设置为 LDAP。

FEATURE_TEAM_SYNCING

布尔值

是否允许团队成员资格从身份验证引擎(OIDC、LDAP 或 Keystone)中的后备组同步。

Default: true

FEATURE_NONSUPERUSER_TEAM_SYNCING_SETUP

布尔值

如果启用，非超级用户可以设置团队同步。

Default: false

LDAP_ADMIN_DN

字符串

用于 LDAP 身份验证的管理员 DN。

LDAP_ADMIN_PASSWD

字符串

LDAP 身份验证的管理员密码。

LDAP_ALLOW_INSECURE_FALLBACK

布尔值

是否允许 SSL insecure fallback 进行 LDAP 身份验证。

LDAP_BASE_DN

String 数组

LDAP 身份验证的基本 DN。

LDAP_EMAIL_ATTR

字符串

LDAP 身份验证的电子邮件属性。

LDAP_UID_ATTR

字符串

LDAP 身份验证的 uid 属性。

LDAP_URI

字符串

LDAP URI。

LDAP_USER_FILTER

字符串

用于 LDAP 身份验证的用户过滤器。

LDAP_USER_RDN

String 数组

用于 LDAP 身份验证的用户 RDN。

LDAP_SECONDARY_USER_RDNS

String 数组

如果用户对象所在的多个机构单元，则提供二级用户相对 DN。

TEAM_RESYNC_STALE_TIME

字符串

如果为团队启用了团队同步，需要检查其成员资格和重新同步。

Pattern:
^[0-9]+(w|m|d|h|s)$
示例：
2h
Default:
30m

LDAP_SUPERUSER_FILTER

字符串

LDAP_USER_FILTER 配置字段的子集。配置后，Red Hat Quay 管理员能够在 Red Hat Quay 使用 LDAP 作为其身份验证提供程序时，将轻量级目录访问协议(LDAP)用户配置为超级用户。

使用此字段，管理员可以添加或删除超级用户，而无需更新 Red Hat Quay 配置文件并重新启动其部署。

此字段要求将 AUTHENTICATION_TYPE 设置为 LDAP。

GLOBAL_READONLY_SUPER_USERS

字符串

设置后，授予此列表的用户对所有存储库的读取权限，无论它们是公共存储库。仅适用于通过 LDAP_SUPERUSER_FILTER 配置字段定义的超级用户。

LDAP_RESTRICTED_USER_FILTER

字符串

LDAP_USER_FILTER 配置字段的子集。配置后，当 Red Hat Quay 使用 LDAP 作为其身份验证提供程序时，Red Hat Quay 管理员能够将轻量级目录访问协议(LDAP)用户配置为受限用户。

此字段要求将 AUTHENTICATION_TYPE 设置为 LDAP。

FEATURE_RESTRICTED_USERS

布尔值

当设为 True 时，LDAP_RESTRICTED_USER_FILTER 处于活动状态时，只有定义的 LDAP 组中的用户才会受到限制。

Default: False

LDAP_TIMEOUT

整数

指定 LDAP 操作的时间限制（以秒为单位）。这限制了 LDAP 搜索、绑定或其他操作可以花费的时间。与 ldapsearch 中的 -l 选项类似，它会设置客户端操作超时。

默认 ：10

LDAP_NETWORK_TIMEOUT

整数

指定与 LDAP 服务器建立连接的时间限制（以秒为单位）。这是 Red Hat Quay 在网络操作期间等待响应的最长时间，类似于 ldapsearch 中的 -o nettimeout 选项。

默认 ：10

FEATURE_REPO_MIRROR

布尔值

启用或禁用存储库镜像

默认： false

REPO_MIRROR_INTERVAL

Number

检查存储库镜像候选者之间的秒数

默认：30

REPO_MIRROR_SERVER_HOSTNAME

字符串

替换 SERVER_HOSTNAME 作为镜像的目的地。

Default: None

Example:
openshift-quay-service

REPO_MIRROR_TLS_VERIFY

布尔值

需要 HTTPS 并在镜像过程中验证 Quay registry 的证书。

默认： true

REPO_MIRROR_ROLLBACK

布尔值

当设置为 true 时，存储库会在镜像失败后回滚。

默认 ：false

FEATURE_SECURITY_SCANNER

布尔值

启用或禁用安全扫描程序

默认： false

FEATURE_SECURITY_NOTIFICATIONS

布尔值

如果启用了安全扫描程序，请打开或关闭安全通知

默认： false

SECURITY_SCANNER_V4_REINDEX_THRESHOLD

字符串

此参数用于决定在重新索引之前具有之前失败或自上索引以来已更改状态的最短时间（以秒为单位）。数据通过 manifestsecuritystatus 表中的 last_indexed datetime 来计算。这个参数用于避免在每次索引运行时都尝试重新索引每个失败清单。重新索引的默认时间为 300 秒。

SECURITY_SCANNER_V4_ENDPOINT

字符串

V4 安全扫描程序的端点

Pattern:
^http (s)?://(.)+$

Example:
http://192.168.99.101:6060

SECURITY_SCANNER_V4_PSK

字符串

Clair 所生成的预共享密钥(PSK)

SECURITY_SCANNER_ENDPOINT

字符串

V2 安全扫描程序的端点

Pattern:
^http (s)?://(.)+$

示例：
http://192.168.99.100:6060

SECURITY_SCANNER_INDEXING_INTERVAL

整数

这个参数用于决定安全扫描程序索引间隔间隔的秒数。当索引被触发时，Red Hat Quay 将查询其数据库以获取由 Clair 索引的清单。这包括尚未索引的清单，以及之前失败的索引清单。

默认值：30

FEATURE_SECURITY_SCANNER_NOTIFY_ON_NEW_INDEX

布尔值

是否允许发送有关新推送的漏洞的通知。
默认:True

SECURITY_SCANNER_V4_MANIFEST_CLEANUP

布尔值

Red Hat Quay 垃圾回收程序会删除没有由其他标签或清单引用的清单。
默认:True

NOTIFICATION_MIN_SEVERITY_ON_NEW_INDEX

字符串

为检测到的漏洞上的新通知设置最小安全级别。避免在首次索引后创建大量通知。如果没有定义，则默认为 High。可用的选项包括 Critical、High、Medium、低、Negligible 和 Unknown。

SECURITY_SCANNER_V4_INDEX_MAX_LAYER_SIZE

字符串

索引允许的最大层大小。如果层大小超过配置的大小，Red Hat Quay UI 会返回 以下消息：此标签的清单具有太大的层，供 Quay Security Scanner 进行索引。默认值为 8G，建议的最大值为 10G。接受的值是 B、K、M、T 和 G。
默认 ：8G

FEATURE_GENERAL_OCI_SUPPORT

布尔值

启用对 OCI 工件的支持。

默认值： True

Helm

application/vnd.cncf.helm.config.v1+json

application/tar+gzip, application/vnd.cncf.helm.chart.content.v1.tar+gzip

Cosign

application/vnd.oci.image.config.v1+json

application/vnd.dev.cosign.simplesigning.v1+json,application/vnd.dsse.envelope.v1+json

SPDX

application/vnd.oci.image.config.v1+json

text/spdx, text/spdx+xml, text/spdx+json

Syft

application/vnd.oci.image.config.v1+json

application/vnd.syft+json

CycloneDX

application/vnd.oci.image.config.v1+json

application/vnd.cyclonedx,application/vnd.cyclonedx+xml,application/vnd.cyclonedx+json

in-toto

application/vnd.oci.image.config.v1+json

application/vnd.in-toto+json

Unknown

application/vnd.cncf.openpolicyagent.policy.layer.v1+rego

application/vnd.cncf.openpolicyagent.policy.layer.v1+rego,application/vnd.cncf.openpolicyagent.data.layer.v1+json

FEATURE_REFERRERS_API

布尔值

启用 OCI 1.1 的引用 API。

IGNORE_UNKNOWN_MEDIATYPES

布尔值

启用后，允许容器 registry 平台对支持的工件类型忽略特定的限制，并接受任何未识别或未知的介质类型。

默认： false

FEATURE_READER_BUILD_LOGS

布尔值

如果设置为 true，则构建日志可以被对存储库具有读取访问权限的用户 读取，而不仅仅是 写入 访问或 admin 访问权限。

Default: False

LOG_ARCHIVE_LOCATION

字符串

在 DISTRIBUTED_STORAGE_CONFIG 中定义的存储位置，用于放置归档的构建日志。

示例： s3_us_east

LOG_ARCHIVE_PATH

字符串

配置的存储引擎下的路径，在其中将归档的构建日志放在 .JSON 格式。

示例： archive /buildlogs

FEATURE_BUILD_SUPPORT

布尔值

是否支持 Dockerfile 构建。

Default: False

SUCCESSIVE_TRIGGER_FAILURE_DISABLE_THRESHOLD

Number

如果没有设置 None，则构建触发器前可能会出现的连续失败次数。

默认： 100

SUCCESSIVE_TRIGGER_INTERNAL_ERROR_DISABLE_THRESHOLD

Number

如果没有设置 None，则构建触发器前可能出现的连续内部错误数量

默认为 5

ALLOWED_WORKER_COUNT

字符串

定义每个 Red Hat Quay pod 实例化多少个 Build Worker。通常设置为 1。

ORCHESTRATOR_PREFIX

字符串

定义添加到所有 Redis 密钥的唯一前缀。这可用于将 Orchestrator 值与其他 Redis 键隔离。

REDIS_HOST

对象

Redis 服务的主机名。

REDIS_PASSWORD

字符串

在 Redis 服务中进行身份验证的密码。

REDIS_SSL

布尔值

定义您的 Redis 连接是否使用 SSL/TLS。

REDIS_SKIP_KEYSPACE_EVENT_SETUP

布尔值

默认情况下，Red Hat Quay 不会在运行时设置关键事件所需的关键空间事件。为此，请将 REDIS_SKIP_KEYSPACE_EVENT_SETUP 设置为 false。

EXECUTOR

字符串

启动此类型的可执行文件定义。有效值为 kubernetes 和 ec2。

BUILDER_NAMESPACE

字符串

将进行 Red Hat Quay 构建的 Kubernetes 命名空间。

K8S_API_SERVER

对象

发生 Builds 的 OpenShift Container Platform 集群的 API 服务器的主机名。

K8S_API_TLS_CA

对象

为 Quay 应用构建集群的 CA 证书的 Quay 容器中的文件路径，以便在发出 API 调用时信任。

KUBERNETES_DISTRIBUTION

字符串

指明正在使用的 Kubernetes 类型。有效值为 openshift 和 k8s。

CONTAINER_*

对象

定义每个构建 Pod 的资源请求和限值。

NODE_SELECTOR_*

对象

定义应调度 构建 Pod 的节点选择器标签名称-值对。

CONTAINER_RUNTIME

对象

指定 Builder 是否应该运行 docker 或 podman。使用红帽的 quay-builder 镜像的客户应将其设置为 podman。

SERVICE_ACCOUNT_NAME/SERVICE_ACCOUNT_TOKEN

对象

定义 构建 Pod 将要使用的服务帐户名称或令牌。

QUAY_USERNAME/QUAY_PASSWORD

对象

定义拉取 WORKER_IMAGE 字段中指定的 Red Hat Quay 构建 worker 镜像所需的 registry 凭证。客户应提供一个 Red Hat Service Account 凭证，如 https://access.redhat.com/RegistryAuthentication 文章中的针对 registry.redhat.io 的"创建 Registry 服务账户"部分。

WORKER_IMAGE

对象

Red Hat Quay Builder 镜像的镜像引用。registry.redhat.io/quay/quay-builder

WORKER_TAG

对象

需要的 Builder 镜像的标签。最新版本为 3。

BUILDER_VM_CONTAINER_IMAGE

对象

对包含运行每个 Red Hat Quay Build. (registry.redhat.io/quay/quay-builder-qemu-rhcos:3)所需的内部虚拟机的完整引用。

SETUP_TIME

字符串

指定在 Build Manager 中尚未注册自身时构建超时的秒数。默认值为 500 秒。尝试重启三次的构建。如果构建在三次尝试后没有注册自己，则被视为失败。

MINIMUM_RETRY_THRESHOLD

字符串

此设置与多个可执行文件一起使用。它指示在选择不同的可执行文件前尝试启动构建的次数。设置为 0 表示对于构建作业需要的次数没有限制。这个值应该保持非常小（三个或更少），以确保在基础架构故障期间快速进行故障转移。必须为此设置指定一个值。例如，Kubernetes 被设置为第一个 executor，EC2 设置为第二个 executor。如果您希望最后一次尝试始终在 EC2 上执行作业，而不是在 EC2 上执行，您可以将 Kubernetes executor 的 MINIMUM_RETRY_THRESHOLD 设置为 1，EC2 的 MINIMUM_RETRY_THRESHOLD 设置为 0 （如果未设置则为 0 ）。在这种情况下，Kubernetes 的 MINIMUM_RETRY_THRESHOLD retries_remaining (1) 将评估为 False，因此回退到配置的第二个 executor。

SSH_AUTHORIZED_KEYS

对象

在 ignition 配置中要引导的 SSH 密钥列表。这允许使用其他密钥通过 SSH 连接到 EC2 实例或 QEMU 虚拟机(VM)。

DIRECT_OAUTH_CLIENTID_WHITELIST

String 数组

允许在没有用户批准的情况下执行直接 OAuth 批准的 Quay 管理应用程序 的客户端 ID 列表。

FEATURE_ASSIGN_OAUTH_TOKEN

布尔值

允许机构管理员将 OAuth 令牌分配给其他用户。

字段

类型

描述

<string>_LOGIN_CONFIG
(Required)

字符串

包含 OIDC 配置设置的父键。通常，OIDC 供应商的名称，如 AZURE_LOGIN_CONFIG，但接受任何任意字符串。

.CLIENT_ID
(Required)

字符串

此 Red Hat Quay 实例的注册的客户端 ID。

示例： 0e8dbe15c4c7630b6780

.CLIENT_SECRET
(Required)

字符串

此 Red Hat Quay 实例注册的客户端 secret。

示例： e4a58ddd3d7408b7aec109e85564a0d153d3e846

.DEBUGLOG

布尔值

是否启用调试。

.LOGIN_BINDING_FIELD

字符串

当内部授权设置为 LDAP 时使用。Red Hat Quay 读取此参数，并尝试使用此用户名为用户搜索 LDAP 树。如果存在，它会自动创建到该 LDAP 帐户的链接。

.LOGIN_SCOPES

对象

添加 Red Hat Quay 用来与 OIDC 供应商通信的其他范围。

.OIDC_ENDPOINT_CUSTOM_PARAMS

字符串

支持 OIDC 端点上的自定义查询参数。支持以下端点： authorization_endpoint、token_endpoint 和 user_endpoint。

.OIDC_ISSUER

字符串

允许用户定义要验证的签发者。例如，JWT 令牌容器是一个称为 的参数，它定义谁发出了令牌。默认情况下，这从 .well-know/openid/configuration 端点读取，该端点由每个 OIDC 供应商公开。如果此验证失败，则没有登录。

.OIDC_SERVER
(Required)

字符串

用于身份验证的 OIDC 服务器地址。

： https://sts.windows.net/6c878…​/

.PREFERRED_USERNAME_CLAIM_NAME

字符串

将首选用户名设置为令牌中的参数。

.SERVICE_ICON

字符串

更改登录屏幕上的图标。

.SERVICE_NAME
(Required)

字符串

正在验证的服务名称。

示例： Microsoft Entra ID

.VERIFIED_EMAIL_CLAIM_NAME

字符串

用于验证用户电子邮件地址的声明名称。

.PREFERRED_GROUP_CLAIM_NAME

字符串

OIDC 令牌有效负载中的密钥名称，其中包含有关用户组成员资格的信息。

.OIDC_DISABLE_USER_ENDPOINT

布尔值

是否允许或禁用 /userinfo 端点。如果使用 Azure Entra ID，则必须将此字段设置为 true，因为 Azure 从令牌中获取用户信息，而不是调用 /userinfo 端点。

默认： false

FEATURE_EXTENDED_REPOSITORY_NAMES

布尔值

启用对嵌套存储库的支持

默认： True

allowlistNamespaces
（可选）

要包含的命名空间列表。

Array

clusterid
(Required)

与此集群关联的 ID。

字符串

credentialsSecret.key
(Required)

包含与 Quay registry 通信的凭据的机密。

对象

denylistNamespaces
（可选）

要排除的命名空间列表。

Array

insecureRegistry
(Optional)

是否跳过 Quay registry 的 TLS 验证

布尔值

quayHostname
(Required)

Quay registry 的主机名。

字符串

scheduledImageStreamImport
(Optional)

是否启用镜像流导入。

布尔值

FEATURE_MAILING

布尔值

电子邮件是否已启用

默认： False

MAIL_DEFAULT_SENDER

字符串

如果指定，在 Red Hat Quay 发送电子邮件时，用作 的电子邮件地址。如果没有，则默认为 support@quay.io

示例： support@example.com

MAIL_PASSWORD

字符串

发送电子邮件时要使用的 SMTP 密码

MAIL_PORT

Number

要使用的 SMTP 端口。如果没有指定，则默认为 587。

MAIL_SERVER

字符串

用于发送电子邮件的 SMTP 服务器。只有在将 FEATURE_MAILING 设置为 true 时才需要。

Example: smtp.example.com

MAIL_USERNAME

字符串

发送电子邮件时要使用的 SMTP 用户名

MAIL_USE_TLS

布尔值

如果指定，是否使用 TLS 发送电子邮件

默认： True

FEATURE_SUPER_USERS

布尔值

超级用户是否被支持

默认： true

FEATURE_USER_CREATION

布尔值

是否可以创建用户（通过非超级用户）

Default: true

FEATURE_USER_LAST_ACCESSED

布尔值

是否记录用户最后一次访问的时间

默认： true

FEATURE_USER_LOG_ACCESS

布尔值

如果设置为 true，则用户有权访问其命名空间的审计日志

默认： false

FEATURE_USER_METADATA

布尔值

是否收集和支持用户元数据

默认： false

FEATURE_USERNAME_CONFIRMATION

布尔值

如果设置为 true，用户可以在通过 OpenID Connect (OIDC)或非数据库内部身份验证供应商（如 LDAP）登录时确认和修改其初始用户名。
默认： true

FEATURE_USER_RENAME

布尔值

如果设置为 true，用户可以重命名自己的命名空间

默认： false

FEATURE_INVITE_ONLY_USER_CREATION

布尔值

创建的用户都必须被其他用户邀请

默认： false

FRESH_LOGIN_TIMEOUT

字符串

新登录需要用户重新输入其密码的时间

示例 ：5m

USERFILES_LOCATION

字符串

存储引擎的 ID，在其中放置用户上传的文件

示例 ：s3_us_east

USERFILES_PATH

字符串

storage 下放置用户上传文件的路径

示例 ：userfiles

USER_RECOVERY_TOKEN_LIFETIME

字符串

恢复用户帐户的令牌的时间长度为有效的

Pattern:^[0-9]+(w|m|d|h|s)$
Default:30m

FEATURE_SUPERUSERS_FULL_ACCESS

布尔值

授予超级用户从命名空间中其他存储库读取、写入和删除它们没有拥有或明确权限的权限。

Default: False

FEATURE_SUPERUSERS_ORG_CREATION_ONLY

布尔值

是否只允许超级用户创建机构。

Default: False

FEATURE_RESTRICTED_USERS

布尔值

当使用 RESTRICTED_USERS_WHITELIST 设置为 True 时：

Default: False

RESTRICTED_USERS_WHITELIST

字符串

使用 FEATURE_RESTRICTED_USERS: true 设置设置时，特定用户不包括在 FEATURE_RESTRICTED_USERS 设置中。

GLOBAL_READONLY_SUPER_USERS

字符串

设置后，授予此列表的用户对所有存储库的读取权限，无论它们是公共存储库。仅适用于通过 SUPER_USERS 配置字段定义的超级用户。

FEATURE_RECAPTCHA

布尔值

用户登录和恢复是否需要 Recaptcha

Default: False

RECAPTCHA_SECRET_KEY

字符串

如果启用了 recaptcha，则 Recaptcha 服务的 secret 键

RECAPTCHA_SITE_KEY

字符串

如果启用了 recaptcha，则 Recaptcha 服务的 site 键

FEATURE_ACI_CONVERSION

布尔值

是否启用转换为 ACI

默认： False

GPG2_PRIVATE_KEY_FILENAME

字符串

用于解密 ACI 的私钥的文件名

GPG2_PRIVATE_KEY_NAME

字符串

用于为 ACI 签名的私钥名称

GPG2_PUBLIC_KEY_FILENAME

字符串

用于加密 ACI 的公钥的文件名

JWT_AUTH_ISSUER

字符串

JWT 用户的端点

Pattern:^http (s)?://(.)+$
Example:http://192.168.99.101:6060

JWT_GETUSER_ENDPOINT

字符串

JWT 用户的端点
Pattern:^http (s)?://(.)+$
Example:http://192.168.99.101:6060

JWT_QUERY_ENDPOINT

字符串

JWT 查询的端点

Pattern:^http (s)?://(.)+$
Example:http://192.168.99.101:6060

JWT_VERIFY_ENDPOINT

字符串

JWT 验证的端点

Pattern:^http (s)?://(.)+$
Example:http://192.168.99.101:6060

FEATURE_APP_SPECIFIC_TOKENS

布尔值

如果启用，用户可以创建供 Docker CLI 使用的令牌

Default: True

APP_SPECIFIC_TOKEN_EXPIRATION

字符串

外部应用程序令牌的过期。

Default None
Pattern: ^[0-9]+(w|m|d|h|s)$

EXPIRED_APP_SPECIFIC_TOKEN_GC

字符串

外部应用程序令牌在垃圾回收前保留的时长

默认： 1d

ALLOW_PULLS_WITHOUT_STRICT_LOGGING

字符串

如果为 true，则即使无法写入拉取审计日志条目，拉取仍会成功。如果数据库处于只读状态，且需要拉取以便在那个时间内继续，则这非常有用。

默认 ： False

AVATAR_KIND

字符串

要显示的 avatars 的类型，可生成内联（本地）或 Gravatar (gravatar)

Values: local, gravatar

BROWSER_API_CALLS_XHR_ONLY

布尔值

如果启用，则只允许从浏览器

Default: True 中标记为由 XHR 发出的 API 调用

DEFAULT_NAMESPACE_MAXIMUM_BUILD_COUNT

Number

可以在命名空间中排队的默认最大构建数。

Default: None

ENABLE_HEALTH_DEBUG_SECRET

字符串

如果指定，可提供给健康端点的 secret，以便在不以超级用户身份验证时查看完整的调试信息

EXTERNAL_TLS_TERMINATION

布尔值

如果支持 TLS，则设置为 true，但在 Quay 之前在层终止。当 Quay 使用其自己的 SSL 证书运行时，设置为 false，并直接接收 TLS 流量。

FRESH_LOGIN_TIMEOUT

字符串

新登录需要用户重新输入密码的时间

示例： 5m

HEALTH_CHECKER

字符串

配置的健康检查

示例： ('RDSAwareHealthCheck', {'access_key': 'foo', 'secret_key': 'bar'})

PROMETHEUS_NAMESPACE

字符串

应用到所有公开的 Prometheus 指标的前缀

默认： quay

PUBLIC_NAMESPACES

String 数组

如果在公共命名空间中定义了命名空间，它将出现在 所有用户 的存储库列表页面上，无论用户是否为命名空间的成员。通常，这由在配置一组 "well-known" 命名空间的企业客户使用。

REGISTRY_STATE

字符串

registry 的状态

值： normal 或 read-only

SEARCH_MAX_RESULT_PAGE_COUNT

Number

用户在限制前可以分页搜索的最大页面数

默认：10

SEARCH_RESULTS_PER_PAGE

Number

搜索页面返回的结果数

默认：10

V2_PAGINATION_SIZE

Number

V2 registry API 中每个页面返回的结果数量

默认： 50

WEBHOOK_HOSTNAME_BLACKLIST

String 数组

在除 localhost 外验证时，从 Webhook 中禁止的主机名集合

CREATE_PRIVATE_REPO_ON_PUSH

布尔值

通过 push 创建新软件仓库是否被设置为私有可见

默认： True

CREATE_NAMESPACE_ON_PUSH

布尔值

新推送到不存在的机构是否将其创建

默认： False

NON_RATE_LIMITED_NAMESPACES

String 数组

如果使用 FEATURE_RATE_LIMITS 启用速率限制，您可以为需要无限访问的特定命名空间覆盖它。

FEATURE_UI_V2

布尔值

设置后，允许用户尝试 beta UI 环境。

Default: True

FEATURE_REQUIRE_TEAM_INVITE

布尔值

在将用户添加到团队时是否需要邀请

默认值： True

FEATURE_REQUIRE_ENCRYPTED_BASIC_AUTH

布尔值

未加密的密码（而不是加密令牌）都可用于基本 auth

默认值： False

FEATURE_RATE_LIMITS

布尔值

是否启用对 API 和 registry 端点的速率限制。将 FEATURE_RATE_LIMITS 设置为 true 会导致 nginx 将某些 API 调用限制为每秒 30 个。如果没有设置该功能，API 调用会每秒限制为 300 个（有效无限）。

Default: False

FEATURE_FIPS

布尔值

如果设置为 true，Red Hat Quay 将使用 FIPS 兼容哈希功能运行

Default: False

FEATURE_AGGREGATED_LOG_COUNT_RETRIEVAL

布尔值

是否允许检索聚合的日志计数

Default: True

FEATURE_ANONYMOUS_ACCESS

布尔值

是否允许匿名用户浏览和拉取公共存储库

默认值： True

FEATURE_DIRECT_LOGIN

布尔值

用户是否可以直接登录到 UI

默认值： True

FEATURE_LIBRARY_SUPPORT

布尔值

从 Docker

默认值拉取和推送时是否允许"无命名空间"存储库默认值

FEATURE_PARTIAL_USER_AUTOCOMPLETE

布尔值

如果设置为 true，则自动完成将应用到部分 usernames+
Default: True

FEATURE_PERMANENT_SESSIONS

布尔值

会话是永久的

默认值： True

FEATURE_PUBLIC_CATALOG

布尔值

如果设置为 true，_catalog 端点会返回公共存储库。否则，只能返回私有存储库。

Default: False

DISABLE_PUSHES

布尔值

禁用将新内容推送到 registry，同时保留所有其他功能。与 只读模式 不同，因为数据库没有 设置为只读。当 DISABLE_PUSHES 设置为 true 时，Red Hat Quay 垃圾收集器被禁用。因此，当启用 PERMANENTLY_DELETE_TAGS 时，使用 Red Hat Quay UI 永久删除标签不会立即删除标签。相反，镜像保留在后端存储中，直到 DISABLE_PUSHES 设置为 false，这会重新启用垃圾收集器。使用 DISABLE_PUSHES 和 PERMANENTLY_DELETE_TAGS 时，应该了解这个注意事项。

Default: False

FEATURE_BLACKLISTED_EMAILS

布尔值

如果设为 true，则在电子邮件域列入黑名单时无法创建新的用户帐户

BLACKLISTED_EMAIL_DOMAINS

String 数组

FEATURE_BLACKLISTED_EMAILS 设置为 true 时使用的电子邮件地址域列表

示例：" example.com", "example.org"

BLACKLIST_V2_SPEC

字符串

Red Hat Quay 将响应 V2 的 Docker CLI 版本 不被支持

示例 ： <1.8.0
Default: &lt ;1.6.0

DOCUMENTATION_ROOT

字符串

文档链接的根 URL。当将 Red Hat Quay 配置为断开连接的环境来设置或允许列表的文档链接时，此字段很有用。

SECURITY_SCANNER_V4_NAMESPACE_WHITELIST

字符串

应该启用安全扫描程序的命名空间

FEATURE_RESTRICTED_V1_PUSH

布尔值

如果设置为 true，则只有 V1_PUSH_WHITELIST 中列出的命名空间支持 V1 push

Default: False

V1_PUSH_WHITELIST

String 数组

如果 FEATURE_RESTRICTED_V1_PUSH 设置为 true，则支持 V1 推送的命名空间名称的数组。

FEATURE_HELM_OCI_SUPPORT

布尔值

启用对 Helm 工件的支持。

默认值： False

ALLOWED_OCI_ARTIFACT_TYPES

对象

允许 OCI 工件 MIME 类型和关联的层类型的集合。

FEATURE_UI_V2

布尔值

设置后，允许用户尝试 beta UI 环境。

+ 默认值： False

FEATURE_UI_V2_REPO_SETTINGS

布尔值

当设置为 True 时，在 Red Hat Quay v2 UI 中启用存储库设置。

+ 默认值： False

FEATURE_LISTEN_IP_VERSION

字符串

启用 IPv4、IPv6 或双栈协议系列。必须正确设置此配置字段，否则 Red Hat Quay 无法启动。

默认： IPv4

其他配置： IPv6、双栈

品牌

对象

Red Hat Quay UI 中的徽标和 URL 的自定义品牌。

.logo
（必需）

字符串

主徽标镜像 URL。

标头徽标默认为 205x30 PX。Web UI 的屏幕上的 Red Hat Quay 登录表格徽标默认为 356.5x39.7 PX。
示例：
/static/img/quay-horizontal-color.svg

.footer_img

字符串

UI footer 的徽标。默认为 144x34 PX.

Example:
/static/img/rhacm.svg

.footer_url

字符串

footer 镜像的链接。

示例：
https://redhat.com

PERMANENT_SESSION_LIFETIME

整数

用于设置永久会话的过期日期 的时间增量。默认值为 31 天，这会在大约一个月后保持永久会话。

默认： 2678400

QUAY_DISTRIBUTED_STORAGE_PREFERENCE

字符串

首选存储引擎（根据 DISTRIBUTED_STORAGE_CONFIG）使用。

DB_CONNECTION_POOLING

字符串

是否要启用或禁用数据库连接池。默认值为 true。接受的值是 "true" 或 "false"

WORKER_CONNECTION_COUNT

Number

同时 HTTP 连接

默认： 50

WORKER_CONNECTION_COUNT_REGISTRY

Number

同步 registry 的 HTTP 连接

默认： WORKER_CONNECTION_COUNT

WORKER_CONNECTION_COUNT_WEB

Number

Web UI 同时 HTTP 连接

默认： WORKER_CONNECTION_COUNT

WORKER_CONNECTION_COUNT_SECSCAN

Number

Clair 的 HTTP 连接

Default: WORKER_CONNECTION_COUNT

WORKER_COUNT

Number

进程数的通用覆盖

WORKER_COUNT_REGISTRY

Number

指定处理 Quay 容器中 Registry 请求的进程数量

值： 8 到 64之间的整数

WORKER_COUNT_WEB

Number

指定处理容器中的 UI/Web 请求的进程数量

值： 2 到 32之间的整数

WORKER_COUNT_SECSCAN

Number

指定处理容器中的安全扫描（如 Clair）集成的进程数量

值： 整数。因为 Operator 为资源请求和限值指定 2 个 vCPU，所以在 2 到 4 之间设置这个值是安全的。但是，如果保证，用户可以运行更多，例如 16 个。

DEBUGLOG

布尔值

是否启用或禁用调试日志。

用户_DEBUG

整数.0 或 1。

用于在明文中调试 LDAP 操作，包括密码。必须与 DEBUGLOG=TRUE 一起使用。