23장. AMQ Streams 업그레이드
AMQ Streams 설치를 버전 2.6으로 업그레이드하고 새로운 기능, 성능 개선 및 향상된 보안 옵션을 활용할 수 있습니다. 업그레이드 중에 Kafka가 지원되는 최신 버전으로 업데이트되어 AMQ Streams 배포에 추가 기능 및 버그 수정이 추가되었습니다.
새 버전에 문제가 발생하면 AMQ Streams를 이전 버전으로 다운그레이드 할 수 있습니다.
릴리스된 AMQ Streams 버전은 AMQ Streams 소프트웨어 다운로드 페이지에서 확인할 수 있습니다.
다운타임 없이 업그레이드
고가용성(최소 3 및 균등하게 분산 파티션의 복제 요소)으로 구성된 주제의 경우 업그레이드 프로세스에서 소비자 및 생산자의 다운타임을 유발하지 않아야 합니다.
업그레이드는 프로세스의 다른 단계에서 브로커를 하나씩 다시 시작하는 롤링 업데이트를 트리거합니다. 이 기간 동안 전체 클러스터 가용성이 일시적으로 줄어들어 브로커가 실패할 경우 메시지 손실 위험이 증가할 수 있습니다.
23.1. AMQ Streams 업그레이드 경로 링크 복사링크가 클립보드에 복사되었습니다!
AMQ Streams에 두 개의 업그레이드 경로를 사용할 수 있습니다.
- 증분 업그레이드
- 증분 업그레이드에는 AMQ Streams를 이전 마이너 버전에서 버전 2.6으로 업그레이드해야 합니다.
- 다중 버전 업그레이드
- 다중 버전 업그레이드에는 이전 버전의 AMQ Streams를 단일 업그레이드 내에서 버전 2.6으로 업그레이드하여 하나 이상의 중간 버전을 건너뜁니다. 예를 들어 AMQ Streams 2.3에서 AMQ Streams 2.6으로 직접 업그레이드할 수 있습니다.
23.1.1. 업그레이드할 때 Kafka 버전 지원 링크 복사링크가 클립보드에 복사되었습니다!
AMQ Streams를 업그레이드할 때 사용 중인 Kafka 버전과의 호환성을 확인하는 것이 중요합니다.
지원되는 Kafka 버전이 이전 버전과 새 버전 간에 다른 경우에도 다중 버전 업그레이드가 가능합니다. 그러나 현재 Kafka 버전을 지원하지 않는 새 AMQ Streams 버전으로 업그레이드하려고 하면 Kafka 버전이 지원되지 않음을 나타내는 오류가 생성됩니다. 이 경우 Kafka 사용자 정의 리소스의 spec.kafka.version 을 새 AMQ Streams 버전에 대해 지원되는 버전으로 변경하여 AMQ Streams 업그레이드의 일부로 Kafka 버전을 업그레이드해야 합니다.
23.1.2. 1.7 이전 버전의 AMQ Streams에서 업그레이드 링크 복사링크가 클립보드에 복사되었습니다!
버전 1.7 이전 버전에서 AMQ Streams의 최신 버전으로 업그레이드하는 경우 다음을 수행하십시오.
- 표준 순서에 따라 AMQ Streams를 버전 1.7로 업그레이드합니다.
-
AMQ Streams와 함께 제공되는 API 변환 툴 을 사용하여 AMQ Streams 사용자 정의 리소스를
v1beta2로 변환합니다. 다음 중 하나를 수행합니다.
-
AMQ Streams 1.8로 업그레이드(
ControlPlaneListener기능 게이트는 기본적으로 비활성화됨). -
ControlPlaneListener기능 게이트를 비활성화하여 AMQ Streams 2.0 또는 2.2(ControlPlaneListener기능 게이트가 기본적으로 활성화되어 있음)로 업그레이드합니다.
-
AMQ Streams 1.8로 업그레이드(
-
ControlPlaneListener기능 게이트를 활성화합니다. - 표준 순서에 따라 AMQ Streams 2.6으로 업그레이드.
AMQ Streams 사용자 정의 리소스는 릴리스 1.7에서 v1beta2 API 버전을 사용하기 시작했습니다. AMQ Streams 1.8 이상으로 업그레이드하기 전에 CRD 및 사용자 정의 리소스를 변환해야 합니다. API 변환 툴 사용에 대한 자세한 내용은 AMQ Streams 1.7 업그레이드 설명서를 참조하십시오.
버전 1.7로 처음 업그레이드하는 대신 버전 1.7에서 사용자 지정 리소스를 설치한 다음 리소스를 변환할 수 있습니다.
이제 AMQ Streams에서 ControlPlaneListener 기능이 영구적으로 활성화됩니다. 비활성화된 AMQ Streams 버전으로 업그레이드한 다음 Cluster Operator 구성에서 STRIMZI_FEATURE_GATES 환경 변수를 사용하여 활성화해야 합니다.
ControlPlaneListener 기능 게이트 비활성화
env:
- name: STRIMZI_FEATURE_GATES
value: -ControlPlaneListener
env:
- name: STRIMZI_FEATURE_GATES
value: -ControlPlaneListener
ControlPlaneListener 기능 게이트 활성화
env:
- name: STRIMZI_FEATURE_GATES
value: +ControlPlaneListener
env:
- name: STRIMZI_FEATURE_GATES
value: +ControlPlaneListener