迁移 Service Registry 部署

流程

1. 使用 exportV1 工具导出 Service Registry 1.1 中的所有数据。这会在当前目录中生成 registry-export.zip 文件：

   java -jar apicurio-registry-utils-exportV1-2.5.10.Final-redhat-00001.jar http://old-registry.my-company.com/api

   Copy to Clipboard Toggle word wrap

2. 使用导入 API 将 .zip 文件导入到 Service Registry 2.x 中：

   curl -X POST "http://new-registry.my-company.com/apis/registry/v2/admin/import" \
     -H "Accept: application/json" -H "Content-Type: application/zip" \
     --data-binary @registry-export.zip

   Copy to Clipboard Toggle word wrap

3. 运行以下命令并比较 count 字段，检查所有工件是否已导入到新的 2.x registry 中：

   curl "http://old-registry.my-company.com/api/search/artifacts"

   Copy to Clipboard Toggle word wrap

   curl "http://new-registry.my-company.com/apis/registry/v2/search/artifacts"

   Copy to Clipboard Toggle word wrap

流程

1. 如果使用 Service Registry Java REST 客户端，您必须更改 Service Registry Java 客户端库的 Maven 依赖项，该库已在版本 2.x 中重新打包：

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-client</artifactId>
       <version>2.5.10.Final-redhat-00001</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

2. 在 Java 客户端应用程序中，您必须更改 registry URL 配置，从指向现有的 v1 API 路径到新的 v2 路径。例如：

   public class ClientExample {
   
       private static final RegistryRestClient client;
   
        public static void main(String[] args) throws Exception {
           // Create a registry client
           String registryUrl = "https://new-registry.my-company.com/apis/registry/v2";
           RegistryClient client = RegistryClientFactory.create(registryUrl);
       }
   }

   Copy to Clipboard Toggle word wrap

   您可以在 Service Registry 用户指南 中找到有关 Java 客户端的更多详细信息。

3. 如果使用 Service Registry SerDes 库，您必须更改 Maven 依赖项，这些依赖项已在版本 2.x 中重新打包。在 Service Registry 1.1 中，SerDes 库只由一个 Maven 依赖项提供：

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-utils-serde</artifactId>
       <version>1.3.2.Final-redhat-00002</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

   在 Service Registry 2.x 中，SerDes 库被分成三个 Maven 依赖项，每个支持的数据格式都有一个： avro、protobuf 和 json 模式，具体取决于您的用例：

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-avro-serde</artifactId>
       <version>2.5.10.Final-redhat-00001</version>
   </dependency>
   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-protobuf-serde</artifactId>
       <version>2.5.10.Final-redhat-00001</version>
   </dependency>
   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-jsonschema-serde</artifactId>
       <version>2.5.10.Final-redhat-00001</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

4. 在 Kafka 生成者和消费者 Java 应用程序中，您必须更改 registry URL 配置，将其从指向现有的 v1 API 路径改为指向新的 v2 路径。例如：

   现有 registry v1 API 路径 ：

   props.putIfAbsent(AbstractKafkaSerDe.REGISTRY_URL_CONFIG_PARAM, "http://old-registry.my-company.com/api");

   Copy to Clipboard Toggle word wrap

   新 registry v2 API 路径 ：

   props.putIfAbsent(SerdeConfig.REGISTRY_URL, "http://new-registry.my-company.com/apis/registry/v2");

   Copy to Clipboard Toggle word wrap

   重构的 SerDes 库还包括其他对配置属性的重要更改。有关 SerDes 配置的详情，请参阅 Service Registry 用户指南。