3.2. 使用 Service Registry Web 控制台添加工件

流程

1. 在 Artifacts 选项卡中，单击 Upload artifact，并指定以下详情：

   • group 和 ID ：使用默认空设置自动生成工件 ID，并将工件 添加到默认 工件组中。或者，您可以输入可选的工件组名称或 ID。

   • 类型 ：使用默认 Auto-Detect 设置来自动检测工件类型，或从列表中选择工件类型，如 Avro Schema 或 OpenAPI。

     注意

     Service Registry 无法自动检测 Kafka Connect Schema 工件类型。您必须手动选择此工件类型。

   • 工件 ：使用以下选项之一指定工件位置：

     • 从文件 ：单击 Browse，然后选择一个文件，或者拖放文件。例如，my-openapi.json 或 my-schema.proto。
     • 从 URL ：输入有效并可访问 URL，然后单击 Fetch。例如： https://petstore3.swagger.io/api/v3/openapi.json。

2. 点 Upload，查看工件详情：

   • 概述 ：显示工件版本元数据，如名称、工件 ID、全局 ID、内容 ID、标签和属性。另外，还显示您可以为工件内容配置的有效性和兼容性的规则。
   • 文档 （仅限 OpenAPI 和 AsyncAPI）：显示自动生成的 REST API 文档。

   • 内容 ：显示完整工件内容的只读视图。对于 JSON 内容，您可以点击 JSON 或 YAML 来显示您首选的格式。

     以下示例显示了 Protobuf 模式工件示例：

     图 3.2. Service Registry web 控制台中的工件详情

     

3. 在 Overview 选项卡上，点击 Edit 铅笔图标以编辑工件元数据，如名称或描述。

   您还可以输入以逗号分隔的标签列表来搜索，或者添加与工件关联的任意属性的键值对。要添加属性，请执行以下步骤：

   1. 单击 Add property。
   2. 输入键名称和值。
   3. 重复前两个步骤来添加多个属性。
   4. 点 Save。
4. 要将工件内容保存到本地文件，例如 my-protobuf-schema.proto，请单击页面末尾的 Download。
5. 要添加一个新的工件版本，点页面标头中的 Upload new version，然后拖放，或者点击 Browse 上传该文件，例如 my-avro-schema.json 或 my-openapi.json。

6. 要删除工件，点页面标头中的 Delete。

   警告

   删除工件会删除工件及其所有版本，无法撤消。工件版本是不可变的，不能单独删除。