第 2 章 Service Registry 内容规则
本章介绍了用于管理 Service Registry 内容的可选规则，并提供了有关可用规则配置的详情：
2.1. 使用规则管理 Service Registry 内容
要管理添加到 Service Registry 中的工件内容的演进，您可以配置可选规则。所有配置的全局规则或特定于工件的规则都必须通过，然后才能将新的工件版本上传到 Service Registry。配置的特定于工件的规则会覆盖任何配置的全局规则。
这些规则的目标是防止将无效内容添加到 Service Registry 中。例如，内容可能会因为以下原因无效：
-
给定工件类型（例如
AVRO或PROTOBUF）的无效语法。 - 有效的语法，但语义违反了规格。
- 不兼容，当新内容包含与当前工件版本相关的更改时。
- 工件参考完整性，例如：重复或不存在的工件引用映射。
您可以使用 Service Registry web 控制台、REST API 命令或 Java 客户端应用程序启用可选内容规则。
2.1.1. 应用规则的时间
只有在将内容添加到 Service Registry 时，才会应用规则。这包括以下 REST 操作：
- 添加工件
- 更新工件
- 添加工件版本
如果违反规则，Service Registry 会返回 HTTP 错误。响应正文包括违反的规则，以及显示错误的消息。
2.1.2. 规则优先级顺序
特定于工件和全局规则的优先顺序如下：
- 如果您启用特定于工件的规则，并且启用了等同的全局规则，工件规则会覆盖全局规则。
- 如果您禁用特定于工件的规则，并且启用了等同的全局规则，则应用全局规则。
- 如果您禁用特定于工件的规则，且禁用了等同的全局规则，则会为所有工件禁用该规则。
-
如果您在工件级别上将规则值设置为
NONE，您需要覆盖启用的全局规则。在这种情况下，工件规则值为NONE优先于这个工件，但启用的全局规则将继续应用到在工件级别禁用规则的任何其他工件。
2.1.3. 规则的工作方式
每个规则都有一个名称和配置信息。Service Registry 维护每个工件的规则列表以及全局规则列表。列表中的每一规则都由规则实施的名称和配置组成。
提供了一个规则，其中包含当前版本的工件内容（如果存在），以及要添加的工件的新版本。根据工件是否通过该规则，规则实施会返回 true 或 false。如果没有，Service Registry 会在 HTTP 错误响应中报告原因。有些规则可能无法使用以前的内容版本。例如，兼容性规则使用之前的版本，但语法或语义有效规则不使用。
其他资源
如需了解更多详细信息，请参阅 第 10 章 Service Registry 内容规则引用。
2.1.4. 内容规则配置
管理员可以配置 Service Registry 全局规则和特定于工件的规则。开发人员只能配置特定于工件的规则。
Service Registry 应用为特定工件配置的规则。如果在这个级别上没有配置规则，Service Registry 会应用全局配置的规则。如果没有配置全局规则，则不会应用规则。
配置工件规则
您可以使用 Service Registry web 控制台或 REST API 配置工件规则。详情请查看以下内容：
配置全局规则
管理员可以以多种方式配置全局规则：
-
在 REST API 中使用
admin/rules操作 - 使用 Service Registry web 控制台
- 使用 Service Registry 应用程序属性设置默认全局规则
配置默认全局规则
管理员可以在应用级别上配置 Service Registry 以启用或禁用全局规则。您可以使用以下应用程序属性格式，在安装时配置默认的全局规则，而无需安装后配置：
registry.rules.global.<ruleName>
目前支持以下规则名称：
-
兼容性 -
有效期 -
完整性
application 属性的值必须是特定于所配置规则的有效配置选项。
您可以将这些应用程序属性配置为 Java 系统属性，或者在 Quarkus application.properties 文件中包含它们。如需了解更多详细信息，请参阅 Quarkus 文档。
