第3章 Apicurio Registry クライアントアプリケーションの移行

手順

1. Apicurio Registry Java REST クライアントを使用している場合は、バージョン 2.x で再パッケージされた Apicurio Registry Java クライアントライブラリーの Maven 依存関係を変更する必要があります。

   Copy to Clipboard Toggle word wrap

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

2. Java クライアントアプリケーションでは、レジストリーの URL 設定を変更し、既存の v1 API パスではなく新しい v2 パスを参照するようにする必要があります。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   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);
       }
   }

   Java クライアントの詳細は、Red Hat build of Apicurio Registry ユーザーガイド を参照してください。

3. Apicurio Registry SerDes ライブラリーを使用している場合は、バージョン 2.x で再パッケージ化された Maven 依存関係を変更する必要があります。Apicurio Registry 1.1 では、SerDes ライブラリーはすべて 1 つの Maven 依存関係のみで提供されていました。

   Copy to Clipboard Toggle word wrap

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

   Apicurio Registry 2.x では、SerDes ライブラリーは、ユースケースに応じて、サポートされる各データ形式 (avro、protobuf、および json schema) ごとに 3 つの Maven 依存関係に分割されました。

   Copy to Clipboard Toggle word wrap

   <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>

4. Kafka プロデューサーおよびコンシューマーアプリケーションでは、レジストリーの URL 設定を変更し、既存の v1 API パスではなく新しい v2 パスを参照するようにする必要があります。以下に例を示します。

   既存のレジストリー v1 API パス:

   Copy to Clipboard Toggle word wrap

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

   新規のレジストリー v2 API パス:

   Copy to Clipboard Toggle word wrap

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

   リファクタリングされた SerDes ライブラリーには、設定プロパティーの他の重要な変更も含まれています。SerDes 設定の詳細は、Red Hat build of Apicurio Registry ユーザーガイド を参照してください。