Service Registry デプロイメントの移行

手順

1. exportV1 ツールを使用して Service Registry 1.1 からすべてのデータをエクスポートします。このコマンドにより、現在のディレクトリーに registry-export.zip ファイルが生成されます。

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

   Copy to Clipboard

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

3. 以下のコマンドを実行して、count フィールドを比較することで、すべてのアーティファクトが新しい 2.x レジストリーにインポートされていることを確認します。

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

   Copy to Clipboard

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

   Copy to Clipboard

手順

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

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-client</artifactId>
       <version>2.0.1.Final</version>
   </dependency>

   Copy to Clipboard

2. Javaクライアントアプリケーションでは、レジストリーの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

   Java クライアントの詳細は、『Service Registry User Guide』を参照してください。

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

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

   Copy to Clipboard

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

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

   Copy to Clipboard

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

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

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

   Copy to Clipboard

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

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

   Copy to Clipboard

   リファクタリングされた SerDes ライブラリーには、設定プロパティーの他の重要な変更も含まれています。SerDes の設定に関する詳細は、『Service Registry User Guide』を参照してください。