3.4. Debezium 버전을 1.x에서 2.1.4로 업그레이드

현재 버전의 Debezium에는 이전 버전에서 업그레이드할 때 특정 단계를 수행해야 하는 변경 사항이 포함되어 있습니다. 자세한 내용은 변경 사항 중단 목록 및 업그레이드 절차를 참조하십시오.

3.4.1. Debezium 2.1.4로 커넥터 업그레이드

Debezium 2.1.4는 새로운 Debezium 주요 릴리스 버전의 첫 번째 Red Hat 릴리스입니다. Debezium 2.1.4의 일부 변경 사항은 이전 버전의 Debezium과 이전 버전과 호환되지 않습니다. 결과적으로 데이터를 보존하고 Debezium 1.x 버전에서 2.1.4로 업그레이드할 때 지속적인 작업을 수행하려면 업그레이드 프로세스 중에 몇 가지 수동 단계를 완료해야 합니다.

한 가지 중요한 변경 사항은 일부 커넥터 매개변수의 이름이 변경되었다는 것입니다. 이러한 변경 사항을 수용하려면 구성 속성 업데이트를 검토하고 커넥터 구성에 있는 속성을 기록해 둡니다. 업그레이드하기 전에 각 Debezium 커넥터의 구성을 편집하여 변경된 속성의 새 이름을 추가합니다. 업그레이드하기 전에 이전 속성 이름과 새 속성 이름이 모두 표시되도록 1.x 커넥터 인스턴스의 구성을 편집합니다. 업그레이드 후 이전 구성 옵션을 제거할 수 있습니다.

사전 요구 사항

  • Debezium은 이제 최대 3.3.1까지 Kafka 버전과 호환됩니다. AMQ Streams 2.3의 기본 Kafka 버전입니다.
  • Java 11 런타임이 필요하며 업그레이드하기 전에 사용 가능해야 합니다. AMQ Streams 2.3은 Java 11을 지원합니다. 새 애플리케이션을 개발할 때 Java 11을 사용합니다. Java 11을 사용하면 새로운 String API 및 서술자 지원 변경과 같은 최근 언어 업데이트를 사용할 수 있으며 Java 성능 개선도 활용할 수 있습니다. AMQ Streams 2.3에서 Java 8은 더 이상 지원되지 않습니다.
  • 차단 변경 목록에서 이전 버전과 호환되는 변경 사항을 확인합니다.
  • 환경이 Debezium 2.1.4 지원 구성을 준수하는지 확인합니다.

절차

  1. OpenShift 콘솔에서 Kafka Connector YAML을 검토하여 Debezium 2.1.4에서 더 이상 유효하지 않은 커넥터 구성을 확인합니다. 자세한 내용은 표 3.1. “커넥터 구성 속성 업데이트” 을 참조하십시오.
  2. 구성을 편집하여 이전 속성 이름과 새 속성 이름이 모두 표시되도록 1단계에서 식별하는 속성에 해당하는 2.x를 추가합니다. 새 속성의 값을 이전 속성에 대해 이전에 지정한 값으로 설정합니다.
  3. OpenShift 콘솔에서 Kafka Connect를 중지하여 커넥터를 정상적으로 중지합니다.
  4. OpenShift 콘솔에서 Kafka Connect 이미지 YAML을 편집하여 커넥터 zip 파일의 Debezium 2.1.4.Final 버전을 참조합니다.
  5. OpenShift 콘솔에서 Kafka Connector YAML을 편집하여 커넥터에 더 이상 유효하지 않은 구성 옵션을 제거합니다.
  6. 코드의 스토리지 모듈 구현 종속 항목에 따라 필요에 따라 애플리케이션의 스토리지 종속성을 조정합니다. 분석 변경 사항 목록에서 Debezium 스토리지 변경 사항을 참조하십시오.
  7. Kafka Connect를 다시 시작하여 커넥터를 시작합니다. 커넥터를 다시 시작한 후 2.1.4.Final 커넥터는 업그레이드 전에 커넥터를 중지한 시점의 이벤트를 계속 처리합니다. 업그레이드가 수정되기 전에 커넥터가 Kafka에 기록된 이벤트 레코드를 변경합니다.