3장. 서비스 레지스트리 클라이언트 애플리케이션 마이그레이션

절차

1. Service Registry Java REST 클라이언트를 사용하는 경우 버전 2.x에서 다시 패키징된 Service Registry Java 클라이언트 라이브러리의 Maven 종속 항목을 변경해야 합니다.

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-client</artifactId>
       <version>2.4.3.Final-redhat-00006</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

2. Java 클라이언트 애플리케이션에서 기존 v1 API 경로를 새 v2 경로로 가리키는 레지스트리 URL 구성을 변경해야 합니다. 예를 들면 다음과 같습니다.

   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

   Java 클라이언트에 대한 자세한 내용은 Service Registry User Guide 에서 확인할 수 있습니다.

3. Service Registry SerDes 라이브러리를 사용하는 경우 버전 2.x에서 다시 패키징된 Maven 종속 항목을 변경해야 합니다. 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

   서비스 레지스트리 2.x에서 SerDes 라이브러리는 사용 사례에 따라 지원되는 각 데이터 형식인 avro,protobuf 및 json 스키마 에 대해 세 가지 Maven 종속성으로 분할되었습니다.

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

   Copy to Clipboard Toggle word wrap

4. Kafka 생산자 및 소비자 Java 애플리케이션에서는 기존 v1 API 경로를 새 v2 경로로 가리키는 레지스트리 URL 구성을 변경해야 합니다. 예를 들면 다음과 같습니다.

   기존 레지스트리 v1 API 경로:

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

   Copy to Clipboard Toggle word wrap

   새 레지스트리 v2 API 경로:

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

   Copy to Clipboard Toggle word wrap

   리팩토링된 SerDes 라이브러리에는 구성 속성에 대한 다른 중요한 변경 사항도 포함되어 있습니다. SerDes 구성에 대한 자세한 내용은 서비스 레지스트리 사용자 가이드를 참조하십시오.