第 8 章 Apicurio Registry 配置参考

registry.api.errors.include-stack-in-response

布尔值

false

2.1.4.final

在错误响应中包含堆栈追踪

registry.disable.apis

可选<list<string>>

2.0.0.Final

禁用 API

registry.auth.admin-override.claim

string

org-admin

2.1.0.Final

Auth 管理员覆盖声明

registry.auth.admin-override.claim-value

string

true

2.1.0.Final

Auth 管理员覆盖声明值

registry.auth.admin-override.enabled

布尔值

false

2.1.0.Final

启用 auth 管理员覆盖

registry.auth.admin-override.from

string

token

2.1.0.Final

Auth admin 覆盖

registry.auth.admin-override.role

string

sr-admin

2.1.0.Final

Auth admin 覆盖角色

registry.auth.admin-override.type

string

role

2.1.0.Final

Auth admin 覆盖类型

registry.auth.anonymous-read-access.enabled

boolean [dynamic]

false

2.1.0.Final

匿名读取访问

registry.auth.audit.log.prefix

string

audit

2.2.6

用于应用程序审计日志记录的前缀。

registry.auth.authenticated-read-access.enabled

boolean [dynamic]

false

2.1.4.final

验证的读取访问权限

registry.auth.basic-auth-client-credentials.cache-expiration

整数

10

2.2.6.final

默认客户端凭证令牌过期时间。

registry.auth.basic-auth-client-credentials.cache-expiration-offset

整数

10

2.5.9.final

客户端凭据到期来自 JWT 过期。

registry.auth.basic-auth-client-credentials.enabled

boolean [dynamic]

false

2.1.0.Final

启用基本身份验证客户端凭证

registry.auth.basic-auth.scope

可选<string>

2.5.0.Final

客户端凭据范围。

registry.auth.client-id

string

2.0.0.Final

服务器用于身份验证的客户端标识符。

registry.auth.client-secret

可选<string>

2.1.0.Final

服务器用于身份验证的客户端机密。

registry.auth.enabled

布尔值

false

2.0.0.Final

启用 auth

registry.auth.owner-only-authorization

boolean [dynamic]

false

2.0.0.Final

工件仅所有者授权

registry.auth.owner-only-authorization.limit-group-access

boolean [dynamic]

false

2.1.0.Final

工件组所有者授权

registry.auth.role-based-authorization

布尔值

false

2.1.0.Final

启用基于角色的授权

registry.auth.role-source

string

token

2.1.0.Final

身份验证角色源

registry.auth.role-source.header.name

string

2.4.3.final

标头授权名称

registry.auth.roles.admin

string

sr-admin

2.0.0.Final

身份验证角色 admin

registry.auth.roles.developer

string

sr-developer

2.1.0.Final

身份验证角色开发人员

registry.auth.roles.readonly

string

sr-readonly

2.1.0.Final

Auth 角色只读

registry.auth.tenant-owner-is-admin.enabled

布尔值

true

2.1.0.Final

启用 auth 租户所有者 admin

registry.auth.token.endpoint

string

2.1.0.Final

身份验证服务器 url.

registry.config.cache.enabled

布尔值

true

2.2.2.final

启用 registry 缓存

registry.ccompat.group-concat.enabled

布尔值

false

2.6.2.Final

通过主题中的串联（兼容性 API）启用组支持。

registry.ccompat.group-concat.separator

string

:

2.6.2.Final

启用组串联时要使用的分隔符（兼容性 API）

registry.ccompat.legacy-id-mode.enabled

boolean [dynamic]

false

2.0.2.final

传统 ID 模式（兼容性 API）

registry.ccompat.max-subjects

integer [dynamic]

1000

2.4.2.final

返回的最大主题数（兼容性 API）

registry.ccompat.use-canonical-hash

boolean [dynamic]

false

2.3.0.Final

规范哈希模式（兼容性 API）

registry.download.href.ttl

long [dynamic]

30

2.1.2.final

下载链接到期

registry.events.ksink

可选<string>

2.0.0.Final

启用事件 Kafka sink

registry.liveness.errors.ignored

可选<list<string>>

1.2.3.final

忽略的存活度错误

registry.metrics.PersistenceExceptionLivenessCheck.counterResetWindowDurationSec

整数

60

1.0.2.final

计数器重置持久性存活度检查的窗口持续时间

registry.metrics.PersistenceExceptionLivenessCheck.disableLogging

布尔值

false

2.0.0.Final

禁用持久性存活度检查的日志记录

registry.metrics.PersistenceExceptionLivenessCheck.errorThreshold

整数

1

1.0.2.final

持久性存活度检查的错误阈值

registry.metrics.PersistenceExceptionLivenessCheck.statusResetWindowDurationSec

整数

300

1.0.2.final

持久性存活度检查的状态重置窗口持续时间

registry.metrics.PersistenceTimeoutReadinessCheck.counterResetWindowDurationSec

整数

60

1.0.2.final

计数器重置持久性就绪度检查的窗口持续时间

registry.metrics.PersistenceTimeoutReadinessCheck.errorThreshold

整数

5

1.0.2.final

持久性就绪度检查的错误阈值

registry.metrics.PersistenceTimeoutReadinessCheck.statusResetWindowDurationSec

整数

300

1.0.2.final

状态重置持久性就绪度检查的窗口持续时间

registry.metrics.PersistenceTimeoutReadinessCheck.timeoutSec

整数

15

1.0.2.final

持久性就绪度检查超时

registry.metrics.ResponseErrorLivenessCheck.counterResetWindowDurationSec

整数

60

1.0.2.final

计数器重置响应存活度检查的窗口持续时间

registry.metrics.ResponseErrorLivenessCheck.disableLogging

布尔值

false

2.0.0.Final

禁用响应存活度检查的日志

registry.metrics.ResponseErrorLivenessCheck.errorThreshold

整数

1

1.0.2.final

响应存活度检查的错误阈值

registry.metrics.ResponseErrorLivenessCheck.statusResetWindowDurationSec

整数

300

1.0.2.final

响应存活度检查的状态重置窗口持续时间

registry.metrics.ResponseTimeoutReadinessCheck.counterResetWindowDurationSec

instance<integer>

60

1.0.2.final

计数器重置响应就绪度检查的窗口持续时间

registry.metrics.ResponseTimeoutReadinessCheck.errorThreshold

instance<integer>

1

1.0.2.final

响应就绪度检查的错误阈值

registry.metrics.ResponseTimeoutReadinessCheck.statusResetWindowDurationSec

instance<integer>

300

1.0.2.final

响应就绪度检查的状态重置窗口持续时间

registry.metrics.ResponseTimeoutReadinessCheck.timeoutSec

instance<integer>

10

1.0.2.final

响应就绪度检查的超时

registry.storage.metrics.cache.check-period

long

30000

2.1.0.Final

存储指标缓存检查周期

registry.import.url

可选<url>

2.1.0.Final

导入 URL

registry.events.kafka.topic

可选<string>

2.0.0.Final

事件 Kafka 主题

registry.events.kafka.topic-partition

可选<integer>

2.0.0.Final

事件 Kafka 主题分区

registry.limits.config.max-artifact-labels

long

-1

2.2.3.final

最大工件标签

registry.limits.config.max-artifact-properties

long

-1

2.1.0.Final

最大工件属性

registry.limits.config.max-artifacts

long

-1

2.1.0.Final

最大工件数

registry.limits.config.max-description-length

long

-1

2.1.0.Final

最大工件描述长度

registry.limits.config.max-label-size

long

-1

2.1.0.Final

最大工件标签大小

registry.limits.config.max-name-length

long

-1

2.1.0.Final

最大工件名称长度

registry.limits.config.max-property-key-size

long

-1

2.1.0.Final

最大工件属性密钥大小

registry.limits.config.max-property-value-size

long

-1

2.1.0.Final

max artifact 属性值大小

registry.limits.config.max-requests-per-second

long

-1

2.2.3.final

每秒的最大工件请求

registry.limits.config.max-schema-size-bytes

long

-1

2.2.3.final

最大模式大小（字节）

registry.limits.config.max-total-schemas

long

-1

2.1.0.Final

最大总模式

registry.limits.config.max-versions-per-artifact

long

-1

2.1.0.Final

每个工件的最大版本

registry.storage.metrics.cache.max-size

long

1000

2.4.1.final

存储指标缓存最大大小。

quarkus.log.level

string

2.0.0.Final

日志级别

registry.enable.multitenancy

布尔值

false

2.0.0.Final

启用多租户

registry.enable.multitenancy.standalone

布尔值

false

2.5.0.Final

启用独立多租户模式。在这个模式中，Registry 提供基本的多租户功能，而不依赖于其他组件来管理租户及其元数据。只有在第一次从请求中提取租户 ID 时，就会立即创建一个新租户。租户 ID 必须在外部管理，并且可通过删除租户的数据来有效地删除租户。

registry.multitenancy.authorization.enabled

布尔值

true

2.1.0.Final

启用多租户授权

registry.multitenancy.reaper.every

可选<string>

2.1.0.Final

多租户获取每个

registry.multitenancy.reaper.max-tenants-reaped

int

100

2.1.0.Final

多租户获取了最大租户数

registry.multitenancy.reaper.period-seconds

long

10800

2.1.0.Final

多租户收发器期间的秒数

registry.multitenancy.tenant.token-claim.names

List<string>

2.1.0.Final

用于解析租户 ID 的令牌声明

registry.multitenancy.types.context-path.base-path

string

t

2.1.0.Final

多租户上下文路径类型基本路径

registry.multitenancy.types.context-path.enabled

布尔值

true

2.1.0.Final

启用多租户上下文路径类型

registry.multitenancy.types.request-header.enabled

布尔值

true

2.1.0.Final

启用多租户请求标头类型

registry.multitenancy.types.request-header.name

string

X-Tenant-Id

2.1.0.Final

多租户请求标头类型名称

registry.multitenancy.types.subdomain.enabled

布尔值

false

2.1.0.Final

启用多租户子域类型

registry.multitenancy.types.subdomain.header-name

string

主机

2.1.0.Final

多租户子域类型标头名称

registry.multitenancy.types.subdomain.location

string

header

2.1.0.Final

多租户子域类型位置

registry.multitenancy.types.subdomain.pattern

string

(\w[\w\d\-]*)\.localhost\.local

2.1.0.Final

多租户子域类型模式

registry.multitenancy.types.token-claims.enabled

布尔值

false

2.1.0.Final

启用多租户请求标头类型

registry.organization-id.claim-name

List<string>

2.1.0.Final

机构 ID 声明名称

registry.tenant.manager.auth.client-id

可选<string>

2.1.0.Final

租户管理器验证客户端 ID

registry.tenant.manager.auth.client-secret

可选<string>

2.1.0.Final

租户管理器身份验证客户端 secret

registry.tenant.manager.auth.enabled

optional<boolean>

2.1.0.Final

启用租户管理器验证

registry.tenant.manager.auth.token.expiration.reduction.ms

可选<long>

2.2.0.Final

租户管理器身份验证令牌过期时间减少 ms

registry.tenant.manager.auth.url.configured

可选<string>

2.1.0.Final

配置租户管理器验证 url

registry.tenant.manager.ssl.ca.path

可选<string>

2.2.0.Final

租户管理器 SSL Ca 路径

registry.tenant.manager.url

可选<string>

2.0.0.Final

租户管理器 URL

registry.tenants.context.cache.check-period

long

60000

2.1.0.Final

租户上下文缓存检查周期

registry.tenants.context.cache.max-size

long

1000

2.4.1.final

租户上下文缓存最大大小

registry.enable-redirects

布尔值

2.1.2.final

启用重定向

registry.redirects

map<string, string>

2.1.2.final

registry 重定向

registry.url.override.host

可选<string>

2.5.0.Final

覆盖用于生成外部访问 URL 的主机名。在部署带有 HTTPS 透传 Ingress 或 Route 的 Registry 时，主机和端口覆盖很有用。在这些情况下，对重定向重新使用的请求 URL （和端口）不属于客户端使用的实际外部 URL，因为请求会被代理。然后重定向会失败，因为目标 URL 无法访问。

registry.url.override.port

可选<integer>

2.5.0.Final

覆盖用于生成外部访问 URL 的端口。

registry.rest.artifact.deletion.enabled

boolean [dynamic]

false

2.4.2-SNAPSHOT

启用工件版本删除

registry.rest.artifact.download.maxSize

int

1000000

2.2.6-SNAPSHOT

允许从 URL 下载的工件的最大大小

registry.rest.artifact.download.skipSSLValidation

布尔值

false

2.2.6-SNAPSHOT

从 URL 下载工件时跳过 SSL 验证

artifacts.skip.disabled.latest

布尔值

true

2.4.2-SNAPSHOT

在检索最新工件版本时跳过带有 DISABLED 状态的工件版本

quarkus.datasource.db-kind

string

postgresql

2.0.0.Final

数据源 Db 类型

quarkus.datasource.jdbc.url

string

2.1.0.Final

数据源 jdbc URL

registry.sql.init

布尔值

true

2.0.0.Final

SQL init

quarkus.oidc.tenant-enabled

布尔值

false

2.0.0.Final

启用 UI OIDC 租户

registry.ui.config.apiUrl

string

1.3.0.Final

UI API URL

registry.ui.config.auth.oidc.client-id

string

none

2.2.6.final

UI 身份验证 OIDC 客户端 ID

registry.ui.config.auth.oidc.redirect-url

string

none

2.2.6.final

UI 身份验证 OIDC 重定向 URL

registry.ui.config.auth.oidc.url

string

none

2.2.6.final

UI 身份验证 OIDC URL

registry.ui.config.auth.type

string

none

2.2.6.final

UI 身份验证类型

registry.ui.config.uiCodegenEnabled

布尔值

true

2.4.2.final

启用 UI codegen

registry.ui.config.uiContextPath

string

/ui/

2.1.0.Final

UI 上下文路径

registry.ui.features.readOnly

boolean [dynamic]

false

1.2.0.Final

UI 只读模式

registry.ui.features.settings

布尔值

false

2.2.2.final

UI 功能设置

registry.ui.root

string

2.3.0.Final

覆盖 UI root 上下文（在使用入站代理重新定位 UI 上下文时很有用）