红帽全球峰会第 1 章 Apicurio Registry 简介
本章介绍了 Apicurio Registry 概念和功能，并提供了有关 registry 中存储的支持的工件类型的详情：
- 第 1.1 节 “什么是 Apicurio Registry？”
- 第 1.2 节 “Apicurio Registry 中的 schema 和 API 工件”
- 第 1.3 节 “使用 Apicurio Registry web 控制台管理内容”
- 第 1.4 节 “用于客户端的 Apicurio Registry REST API”
- 第 1.5 节 “Apicurio Registry 存储选项”
- 第 1.6 节 “使用 schema 和 Java 客户端序列化器/反序列化器验证 Kafka 消息”
- 第 1.7 节 “使用 Kafka Connect 转换器将数据流传输到外部系统”
- 第 1.8 节 “Apicurio Registry 演示示例”
- 第 1.9 节 “Apicurio Registry 可用发行版本”
1.1. 什么是 Apicurio Registry？
Apicurio Registry 是一个数据存储，用于在事件驱动的和 API 构架间共享标准事件模式和 API 设计。您可以使用 Apicurio Registry 将数据的结构与客户端应用程序分离，并使用 REST 接口在运行时共享和管理您的数据类型和 API 描述。
客户端应用程序可以在运行时动态向 Apicurio Registry 或从 Apicurio Registry 推送或拉取最新的 schema 更新，而无需重新部署。开发人员团队可以查询 Apicurio Registry 以获取已在生产中部署的服务所需的现有模式，并可注册开发中新服务所需的新模式。
您可以通过在客户端应用程序代码中指定 Apicurio Registry URL 来启用客户端应用程序使用模式和 API 设计。Apicurio Registry 可以存储用于序列化和反序列化消息的模式，这些消息从客户端应用程序引用，以确保它们发送和接收的消息与这些模式兼容。
使用 Apicurio Registry 将数据结构与应用程序分离，方法是降低整体消息大小降低成本，并通过增加跨机构的模式和 API 设计的一致重复使用来提高效率。Apicurio Registry 提供了一个 Web 控制台，方便开发人员和管理员管理 registry 内容。
您可以配置可选规则来管理 Apicurio Registry 内容的演进。这包括确保上传的内容有效或与其他版本兼容的规则。任何配置的规则都必须在将新版本上传到 Apicurio Registry 前传递，这样可确保时间在无效或不兼容的模式或 API 设计中不会受到影响。
Apicurio Registry 基于 Apicurio Registry 开源社区项目。详情请查看 https://www.apicur.io/registry/。
Apicurio Registry 功能
- 标准事件模式和 API 规格的多个有效负载格式，如 Apache Avro、JSON Schema、Google Protobuf、AsyncAPI、OpenAPI 等。
- 可插拔 Apicurio Registry 存储选项，用于将内容存储在 AMQ Streams 或 PostgreSQL 数据库中。
- 内容验证、兼容性和完整性规则，以管理 Apicurio Registry 内容随时间变化的方式。
- 使用 Web 控制台、REST API、命令行、Maven 插件或语言 SDK 管理 Apicurio Registry 内容管理。
- 完整的 Apache Kafka 模式 registry 支持，包括与外部系统的 Kafka Connect 集成。
- Kafka 客户端序列化器/反序列化器(SerDes)，在运行时验证消息类型。
- 与现有 Confluent 模式 registry 客户端应用程序兼容。
- 用于低内存占用和快速部署时间的云原生 Quarkus Java 运行时。
- 基于 Operator 的 Apicurio Registry 在 OpenShift/Kubernetes 上安装。
- 使用红帽构建的 Keycloak 进行 OpenID Connect (OIDC)身份验证。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}