26.2. KRaft ベースの Kafka クラスターとクライアントアプリケーションのダウングレード


KRaft ベースの Streams for Apache Kafka クラスターを以前のバージョンにダウングレードします。KRaft ベースの Streams for Apache Kafka クラスターを下位バージョンにダウングレードする場合 (3.7.0 から 3.6.0 に移行する場合など)、Kafka クラスターで使用されているメタデータバージョンが、ダウングレード先の Kafka バージョンでサポートされているバージョンであることを確認してください。ダウングレード元の Kafka バージョンのメタデータバージョンは、ダウングレード先のバージョンより高くすることはできません。

注記

KRaft ベースのダウングレードに関連するサポートと制限事項については、Apache Kafka のドキュメントを参照してください。

前提条件

  • Cluster Operator が稼働中である。
  • Streams for Apache Kafka クラスターをダウングレードする前に、Kafka リソースについて次の点を確認してください。

    • Kafka カスタムリソースには、ダウングレードされる Kafka バージョンでサポートされていないオプションは含まれません。
    • spec.kafka.metadataVersion は、ダウングレードされる Kafka バージョンでサポートされるバージョンに設定されます。

手順

  1. Kafka クラスター設定を更新します。

    oc edit kafka <kafka_configuration_file>
  2. metadataVersion バージョンを、ダウングレードする Kafka バージョンでサポートされているバージョンに変更します。Kafka.spec.kafka.version現在の Kafka バージョンのままにしておきます。

    たとえば、Kafka 3.7.0 から 3.6.0 にダウングレードする場合:

    apiVersion: kafka.strimzi.io/v1beta2
    kind: Kafka
    metadata:
      name: my-cluster
    spec:
      kafka:
        replicas: 3
        metadataVersion: 3.6-IV2 1
        version: 3.7.0 2
        # ...
    1
    メタデータのバージョンは、以前の Kafka バージョンでサポートされているバージョンに変更されます。
    2
    Kafka のバージョンは変更されていません。
    注記

    metadataVersion の値は、浮動小数点数として解釈されないように文字列にする必要があります。

  3. 変更を保存し、Cluster Operator が Kafka リソースの .status.kafkaMetadataVersion を更新するまで待ちます。
  4. Kafka.spec.kafka.version を以前のバージョンに変更します。

    たとえば、Kafka 3.7.0 から 3.6.0 にダウングレードする場合:

    apiVersion: kafka.strimzi.io/v1beta2
    kind: Kafka
    metadata:
      name: my-cluster
    spec:
      kafka:
        replicas: 3
        metadataVersion: 3.6-IV2 1
        version: 3.6.0 2
        # ...
    1
    メタデータのバージョンは、Kafka のバージョンでサポートされています。
    2
    Kafka のバージョンが新しいバージョンに変更されます。
  5. Kafka バージョンのイメージが Cluster Operator の STRIMZI_KAFKA_IMAGES に定義されているイメージとは異なる場合は、Kafka.spec.kafka.image を更新します。

    「Kafka バージョンおよびイメージマッピング」を参照してください。

  6. Cluster Operator によってクラスターが更新されるまで待ちます。

    Kafka リソースのステータスからダウングレードが正常に完了したことを確認 できます。

  7. すべてのクライアントアプリケーション (コンシューマー) をダウングレードして、以前のバージョンのクライアントバイナリーを使用します。

    これで、Kafka クラスターおよびクライアントは以前の Kafka バージョンを使用するようになります。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.