Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

31.2. Streams for Apache Kafka のアップグレードパス

Streams for Apache Kafka には 2 つのアップグレードパスがあります。

増分アップグレード
増分アップグレードは、サポートされているアップグレードパスに従って、連続するマイナーバージョン (2.8 から 2.9 など) 間を移動します。
マルチバージョンアップグレード
マルチバージョンアップグレードでは、1 つ以上のマイナーバージョンがスキップされ、連続する長期サポート (LTS) バージョン間でのみサポートされます。OperatorHub から対象の LTS バージョンのバージョン固有のチャネルを選択し、Kafka バージョンを手動で更新することで、マルチバージョンアップグレードを実行できます。Kafka バージョンの変更により一時的なエラーが発生する可能性がありますが、これは予期されたものであり、アップグレード中に Kafka バージョンを更新することで解決できます。

実稼働環境でアップグレードする前に、制御された環境で特定のシナリオをテストして、発生する可能性のある問題を特定します。

重要

LTS チャネル (amq-streams-lts) では、マルチバージョンアップグレードはサポートされていません。これ以上の LTS バージョンは LTS チャネルに追加されません。これは非推奨であり、後のリリースで削除されます。LTS バージョン間のアップグレードには、バージョン固有のチャネルを使用します。

31.2.1. アップグレード時の Kafka バージョンのサポート
リンクのコピー

Streams for Apache Kafka をアップグレードする場合、使用中の Kafka バージョンとの互換性を確保することが重要です。

サポートされている Kafka バージョンが新旧バージョンで異なる場合でも、マルチバージョンアップグレードが可能です。ただし、現在の Kafka バージョンをサポートしていない新しい Streams for Apache Kafka バージョンにアップグレードしようとすると、Kafka バージョンがサポートされていないことを示すエラーが生成 されます。この場合、Kafka カスタムリソースの spec.kafka.version を、新しい Streams for Apache Kafka バージョンでサポートされているバージョンに変更して、Streams for Apache Kafka のアップグレード中に Kafka バージョンをアップグレードする必要があります。

31.2.2. 1.7 より前のバージョンの Streams for Apache Kafka からアップグレードする
リンクのコピー

バージョン 1.7 より前のバージョンから Streams for Apache Kafka の最新バージョンにアップグレードする場合は、次の手順を実行します。

  1. 標準の手順 に従って、Streams for Apache Kafka をバージョン 1.7 にアップグレードします。
  2. Streams for Apache Kafka に付属する API 変換ツール を使用して、Streams for Apache Kafka カスタムリソースを v1beta2 に変換します。

  3. 次のいずれかを行います。

    • Streams for Apache Kafka をバージョン 1.8 (ControlPlaneListener フィーチャーゲートがデフォルトで無効) にアップグレードします。
    • ControlPlaneListener フィーチャーゲートを無効にして、Streams for Apache Kafka をバージョン 2.0 - 2.2 (ControlPlaneListener フィーチャーゲートがデフォルトで有効) にアップグレードします。
  4. ControlPlaneListener フィーチャーゲートを有効化します。
  5. 標準の手順 に従って、Streams for Apache Kafka 2.9 にアップグレードします。

Streams for Apache Kafka のカスタムリソースでは、リリース 1.7 から v1beta2 API バージョンの使用を開始しました。Streams for Apache Kafka 1.8 にアップグレードする 前 に、CRD とカスタムリソースを変換する必要があります。API 変換ツールの使用方法は、Streams for Apache Kafka 1.7 アップグレードドキュメント を参照してください。

注記

最初にバージョン 1.7 にアップグレードする代わりに、カスタムリソースをバージョン 1.7 からインストールしてから、リソースを変換することができます。

ControlPlaneListener 機能が、Streams for Apache Kafka で永続的に有効になりました。この機能が無効な Streams for Apache Kafka のバージョンにアップグレードしてから、Cluster Operator 設定の STRIMZI_FEATURE_GATES 環境変数を使用して有効にする必要があります。

ControlPlaneListener フィーチャーゲートの無効化

env:
  - name: STRIMZI_FEATURE_GATES
    value: -ControlPlaneListener

ControlPlaneListener フィーチャーゲートの有効化

env:
  - name: STRIMZI_FEATURE_GATES
    value: +ControlPlaneListener

31.2.3. Kafka バージョンおよびイメージマッピング
リンクのコピー

Kafka のアップグレード時に、STRIMZI_KAFKA_IMAGES 環境変数と Kafka.spec.kafka.version プロパティーの設定を考慮してください。

  • 各 Kafka リソースは Kafka.spec.kafka.version を使用して設定できます。指定しない場合は、デフォルトでサポートされている最新の Kafka バージョン (3.9.0) が設定されます。

  • Cluster Operator の STRIMZI_KAFKA_IMAGES 環境変数は、Kafka バージョンと、特定の Kafka リソースで特定の Kafka バージョンが要求されたときに使用されるイメージとの間のマッピング (<kafka_version>=<image>) を提供します。例：3.9.0=registry.redhat.io/amq-streams/kafka-39-rhel9:2.9.3

    • Kafka.spec.kafka.image を設定しないと、そのバージョンのデフォルトのイメージが使用されます。
    • Kafka.spec.kafka.image を設定すると、デフォルトのイメージがオーバーライドされます。
警告

Cluster Operator は、Kafka ブローカーの想定されるバージョンが実際にイメージに含まれているかどうかを検証できません。所定のイメージが所定の Kafka バージョンに対応することを必ず確認してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る