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