第 2 章 Service Registry 内容规则

本章论述了用来管理 registry 内容的可选规则，并提供了有关可用规则配置的详情：

2.1. 使用规则管理 registry 内容

要管理 registry 内容的演进，您可以为添加到 registry 中的工件内容配置可选规则。所有配置的全局规则或构件规则都必须通过，然后才能将新的工件版本上传到 registry。配置工件规则覆盖任何配置的全局规则。

这些规则的目的是防止将无效的内容添加到 registry 中。例如，内容可能会因为以下原因无效：

您可以使用 Service Registry Web 控制台、REST API 命令或 Java 客户端应用程序启用可选内容规则。

只有在内容添加到 registry 时，才会应用规则。这包括以下 REST 操作：

如果违反规则，Service Registry 会返回 HTTP 错误。响应正文包含违反的规则，以及显示错误的消息。

您可以在全局级别和工件级别配置 Service Registry 内容规则。优先级顺序如下：

如果您启用工件规则和对应的全局规则，则工件规则会覆盖全局规则。
如果您禁用工件规则，并且启用相同的全局规则，则应用全局规则。
如果您在工件级别和全局级别上禁用规则，您可以禁用所有工件的规则。
如果您在工件级别将规则值设置为 NONE，则会覆盖启用的全局规则。在本例中，工件规则值 NONE 优先于这个工件，但启用的全局规则将继续应用到工件级别禁用该规则的任何其他工件。

每个规则都有一个名称和配置信息。registry 维护每个工件和全局规则列表的规则列表。列表中的每个规则都包含规则实施的名称和配置。

提供了包含工件当前版本的内容（如果存在）以及正在添加的工件的新版本。规则实施根据工件通过规则返回 true 或 false。如果没有，registry 会报告 HTTP 错误响应的原因。有些规则可能无法使用旧版本的内容。例如，兼容性规则使用之前的版本，但语法或语义有效规则不会发生。

其他资源

如需了解更多详细信息，请参阅第 9 章 Service Registry 工件参考。

您可以为每个工件以及全局配置规则。Service Registry 应用为特定工件配置的规则。如果没有在该级别上配置规则，则 Service Registry 将应用全局配置的规则。如果没有配置全局规则，则不会应用任何规则。

您可以使用 Service Registry web 控制台或 REST API 配置工件规则。详情请查看以下内容：

您可以通过几种方法配置全局规则：

配置默认全局规则

您可以在应用程序级别上配置 Service Registry，以启用或禁用全局规则。您可以在安装时使用以下应用程序属性格式配置默认全局规则，而无需安装后配置：

registry.rules.global.<ruleName>

目前支持以下规则名称：

application 属性的值必须是有效的配置选项，特定于所配置的规则。

注意

您可以将这些应用程序属性配置为 Java 系统属性，或者在 Quarkus application.properties 文件中包含它们。如需了解更多详细信息，请参阅 Quarkus 文档。