迁移 Service Registry 部署

流程

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

   java -jar apicurio-registry-utils-exportV1-2.3.0.Final.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.3.0.Final</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

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

   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</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

4. 在 Kafka producer 和消费者 Java 应用程序中，您必须更改 registry URL 配置，使其指向新的 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 用户指南。