Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

25.2. Apache Kafka 업그레이드 경로 스트림

Apache Kafka용 Streams에 두 개의 업그레이드 경로를 사용할 수 있습니다.

증분 업그레이드
증분 업그레이드에는 이전 마이너 버전에서 버전 2.7로 Apache Kafka의 Streams를 업그레이드해야 합니다.
다중 버전 업그레이드
다중 버전 업그레이드에는 Apache Kafka의 이전 버전의 Streams를 단일 업그레이드 내에서 버전 2.7으로 업그레이드하여 하나 이상의 중간 버전을 건너뜁니다. 예를 들어 Streams for Apache Kafka 2.3.0에서 Apache Kafka 2.7의 Streams로 직접 업그레이드할 수 있습니다.

25.2.1. 업그레이드할 때 Kafka 버전 지원
링크 복사

Apache Kafka용 Streams를 업그레이드할 때 사용 중인 Kafka 버전과의 호환성을 확인하는 것이 중요합니다.

지원되는 Kafka 버전이 이전 버전과 새 버전 간에 다른 경우에도 다중 버전 업그레이드가 가능합니다. 그러나 현재 Kafka 버전을 지원하지 않는 Apache Kafka 버전의 새 Streams로 업그레이드하려고 하면 Kafka 버전이 지원되지 않음을 나타내는 오류가 생성됩니다. 이 경우 Kafka 사용자 정의 리소스의 spec.kafka.version 을 새 Streams for Apache Kafka 버전에 대해 지원되는 버전으로 변경하여 Apache Kafka 에 대한 Streams for Apache Kafka 업그레이드의 일부로 Kafka 버전을 업그레이드해야 합니다.

25.2.2. 1.7 이전의 Apache Kafka용 Streams에서 업그레이드
링크 복사

버전 1.7 이전 버전에서 Apache Kafka의 최신 버전으로 업그레이드하는 경우 다음을 수행합니다.

  1. 표준 순서에 따라 Apache Kafka의 Streams를 버전 1.7로 업그레이드합니다.
  2. Apache Kafka 사용자 정의 리소스의 Streams를 Apache Kafka용 Streams와 함께 제공되는 API 변환 툴 을 사용하여 v1beta2 로 변환합니다.

  3. 다음 중 하나를 수행합니다.

    • Apache Kafka의 Streams를 1.8에서 0.26 사이의 버전으로 업그레이드합니다. 여기서 ControlPlaneListener 기능 게이트는 기본적으로 비활성화되어 있습니다.
    • Apache Kafka의 Streams를 2.0에서 0.31(기본적으로 ControlPlaneListener 기능 게이트가 활성화되어 있음)과 ControlPlaneListener 기능 게이트가 비활성화된 버전으로 업그레이드합니다.
  4. ControlPlaneListener 기능 게이트를 활성화합니다.
  5. 표준 순서에 따라 Apache Kafka 2.7의 Streams로 업그레이드.

Apache Kafka 사용자 정의 리소스의 스트림은 릴리스 1.7에서 v1beta2 API 버전을 사용하기 시작했습니다. Apache Kafka 1.8 이상 버전으로 업그레이드하기 전에 CRD 및 사용자 정의 리소스를 변환해야 합니다. API 변환 툴 사용에 대한 자세한 내용은 Apache Kafka 1.7 업그레이드 설명서 를 참조하십시오.

참고

버전 1.7로 처음 업그레이드하는 대신 버전 1.7에서 사용자 지정 리소스를 설치한 다음 리소스를 변환할 수 있습니다.

이제 ControlPlaneListener 기능이 Apache Kafka용 Streams에서 영구적으로 활성화됩니다. 비활성화된 Apache Kafka용 Streams 버전으로 업그레이드한 다음 Cluster Operator 구성에서 STRIMZI_FEATURE_GATES 환경 변수를 사용하여 활성화해야 합니다.

ControlPlaneListener 기능 게이트 비활성화

env:
  - name: STRIMZI_FEATURE_GATES
    value: -ControlPlaneListener
Copy to Clipboard Toggle word wrap

ControlPlaneListener 기능 게이트 활성화

env:
  - name: STRIMZI_FEATURE_GATES
    value: +ControlPlaneListener
Copy to Clipboard Toggle word wrap

25.2.3. Kafka 버전 및 이미지 매핑
링크 복사

Kafka를 업그레이드할 때 STRIMZI_KAFKA_IMAGES 환경 변수 및 Kafka.spec.kafka.version 속성에 대한 설정을 고려하십시오.

  • 각 Kafka 리소스는 지정되지 않은 경우 지원되는 최신 Kafka 버전 (3.7.0)으로 기본 제공되는 Kafka.spec.kafka.version 을 사용하여 구성할 수 있습니다.

  • Cluster Operator의 STRIMZI_KAFKA_IMAGES 환경 변수는 Kafka 버전과 지정된 Kafka 리소스에서 특정 Kafka 버전을 요청할 때 사용할 이미지 간 매핑 (<kafka_version>=<image>)을 제공합니다. 예: 3.7.0=registry.redhat.io/amq-streams/kafka-37-rhel9:2.7.0.

    • Kafka.spec.kafka.image 가 구성되지 않은 경우 지정된 버전의 기본 이미지가 사용됩니다.
    • Kafka.spec.kafka.image 가 구성된 경우 기본 이미지가 재정의됩니다.
주의

Cluster Operator는 이미지에 예상 버전의 Kafka 브로커가 실제로 포함되어 있는지 확인할 수 없습니다. 지정된 이미지가 지정된 Kafka 버전에 해당하는지 확인합니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat