迁移 Apicurio Registry 部署

流程

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

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

   Copy to Clipboard Toggle word wrap

2. 使用导入 API 将 .zip 文件导入到 Apicurio 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. 如果您使用 Apicurio Registry Java REST 客户端，您必须更改 Apicurio Registry Java 客户端库的 Maven 依赖项，在版本 2.x 中被重新打包：

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-client</artifactId>
       <version>2.3.3.Final</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

   您可以在 红帽构建的 Apicurio Registry User Guide 中找到有关 Java 客户端的更多详细信息。

3. 如果您使用 Apicurio Registry SerDes 库，您必须更改 Maven 依赖项，这已在 2.x 版本中重新打包。在 Apicurio 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

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

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-avro-serde</artifactId>
       <version>2.3.3.Final</version>
   </dependency>
   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-protobuf-serde</artifactId>
       <version>2.3.3.Final</version>
   </dependency>
   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-serdes-jsonschema-serde</artifactId>
       <version>2.3.3.Final</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 配置的详情，请参阅 Red Hat build of Apicurio Registry User Guide。