# Strimzi 0.45.1

2025-06-27 · [元のリリースノート](https://github.com/strimzi/strimzi-kafka-operator/releases/tag/0.45.1) · [全体のまとめ](https://ratatosk.io/ja/releases/strimzi/0.45.1)

セキュリティ 2 · 破壊的変更 3 · 重大な修正 3 · 機能・改善 3 · 依存関係の更新 8 · その他の変更 10

## アップグレード前の確認事項

### 前提条件

- **Strimzi 0.45 における Kubernetes 1.23 および 1.24 のサポート削除**: 最低サポートバージョンは Kubernetes 1.25 です。
  > ⚠️ **Important: Strimzi 0.45 supports only Kubernetes 1.25 and newer. Kubernetes 1.23 and 1.24 are not supported anymore.**
- **ZooKeeper クラスターおよび MirrorMaker 1 をサポートする Strimzi の最終リリース**: Strimzi 0.46 以降にアップグレードするには、KRaft と MirrorMaker 2 への移行が必要です。
  > * **Strimzi 0.45 is the last minor Strimzi version with support for ZooKeeper-based Apache Kafka clusters and MirrorMaker 1 deployments.**
  >   **Please make sure to [migrate to KRaft](https://strimzi.io/docs/operators/latest/full/deploying.html#assembly-kraft-mode-str) and MirrorMaker 2 before upgrading to Strimzi 0.46 or newer.**

  - KRaft デプロイメントに必要な `Kafka` および `KafkaNodePool` カスタムリソース
  - KRaft メタデータとの Kafka バージョン互換性
  - すべてのデプロイメントでの静的コントローラークォーラムの使用: Apache Kafka は静的クォーラムと動的クォーラム間の移行をサポートしていないため、静的クォーラムを使用している既存の KRaft クラスターでは、引き続き静的クォーラムを使用する必要があります。
  - コントローラークォーラムのスケーリングではコントローラーノードプールを追加・削除できない
  - 動的なコントローラークォーラムのスケーリングでは既存ノードプールにコントローラーロールを追加不可
  - コントローラークォーラムのスケーリング時に既存ノードプールからコントローラーロールを削除できない問題
  - 動的なコントローラークォーラムのスケーリングではコントローラーノードプールをスケーリングできない問題
  - 動的クォーラムスケーリング時のコントローラーノードプール名変更の非対応
  - 静的コントローラークォーラムによるコントローラーロールのノードプールのストレージタイプ変更の阻止: JBOD 以外のストレージでは、古いプールを希望するストレージタイプを使用する新しいプールに置き換える際、サポートされていないスケーリング操作も必要になります。
  - スケーリング回避策としてのコントローラーノードへのブローカーロール配置: コントローラーのスケーリングを避けられますが、より多くのデータを再割り当てする必要があり、クラスターのパフォーマンスに一時的な影響が出る可能性があります。
  - ZooKeeper ベースのクラスターのアップグレード前に必要な KRaft への移行
- **Strimzi 0.22 以前からの直接アップグレードへの非対応**: サポートされるアップグレード経路は、以前の Strimzi バージョンを経由し、CRD リソースを変換する方法です。
  > **Direct upgrade from Strimzi 0.22 or earlier is not supported anymore!** You have to upgrade first to one of the previous versions of Strimzi. You will also need to convert the CRD resources. For more details, see the [documentation](https://strimzi.io/docs/operators/0.45.1/deploying.html#assembly-upgrade-str).

### アップグレードガイド

- **アップグレード手順のドキュメント**
  > See the [documentation for upgrade instructions](https://strimzi.io/docs/operators/0.45.1/deploying.html#assembly-upgrade-str).

  - ブローカーのローリングアップデート中のメッセージ損失リスク: アップグレード中、ブローカーは段階的に1台ずつ再起動するため、クラスターの可用性が一時的に低下します。この期間中にブローカー障害が発生すると、メッセージ損失のリスクが高まる可能性があります。
  - Kafka ブローカーとクライアントのアップグレード手順の順序: 記載された順序で手順を完了すると、ブローカーとクライアントをダウンタイムなしでアップグレードできます。
  - Strimzi 0.45.1 の実行に必要な Kubernetes 1.25
  - Kafka のアップグレード順序における Cluster Operator の先行実行
  - KRaft アップグレード時の Kafka バージョンおよび `spec.kafka.metadataVersion` の更新: アップグレードの対象には、すべての Kafka ブローカーとクライアントアプリケーションが含まれます。
  - ZooKeeper ベースの Kafka アップグレードの前提条件: すべての Kafka ブローカーとクライアントアプリケーションをアップグレードするには、Kafka のバージョンと `inter.broker.protocol.version` を更新する必要があります。
  - KRaftベースのクラスター間のアップグレードとダウングレードに対応: この機能は Strimzi 0.39 以降で利用できます。
  - 直前のマイナーバージョンから Strimzi 0.45.1 への段階的アップグレード
  - Kafka の対応バージョンが異なる場合の複数バージョンをまたぐ Strimzi アップグレード: 新しい Strimzi バージョンが現在の Kafka バージョンをサポートしていない場合、サポート対象外バージョンのエラーが報告されます。記載されている解決方法は、新しい Strimzi バージョンがサポートする Kafka バージョンを `spec.kafka.version` に設定することです。
  - Strimzi 0.22より前のバージョンからのアップグレード経路: 記載されている手順では、0.22を経由し、カスタムリソースを`v1beta2`に変換したうえで、`ControlPlaneListener`を無効にしたバージョン（またはデフォルトで有効だが、ゲートを無効にしたバージョン）を使用します。その後、フィーチャーゲートを有効にして0.45.1に到達します。別の方法として、先に0.22へアップグレードせずに、0.22のカスタムリソースをインストールして変換できます。
  - Kafka ブローカーのバージョンとイメージの照合は未検証: Cluster Operator は、イメージに要求された Kafka バージョンのブローカーが含まれているかを確認できません。イメージがその Kafka バージョンに対応していることを確認するよう注意されています。
  - Kubernetes のアップグレード経路と対応バージョンの案内
  - Kubernetes のアップグレード中の Kafka の可用性
  - 高可用性アップグレードの前提条件: トピックのレプリケーション係数は3以上にし、`min.insync.replicas` はその1つ下の値に設定する必要があります。例では `replicas: 3`、`min.insync.replicas: 2` を使用しています。高可用性環境では、Cluster Operator がアップグレード中に同期中レプリカの最小数を維持し、ダウンタイムを回避します。
  - Cluster Operator のアップグレードに初回デプロイ方式を使用
  - バージョン別のアップグレードドキュメント
  - この手順で必要となる既存の Cluster Operator デプロイメント
  - Strimzi 0.45.1 のリリースアーティファクトのダウンロードが必要
  - `CustomResourceDefinition`、`ClusterRole`、`RoleBinding` リソースの作成・管理に必要なアカウント権限
  - 以前の Cluster Operator 設定変更の記録: 新しいバージョンでは、それらの変更が上書きされます。
  - Strimzi 0.45.1 の設定オプションに関するカスタムリソースの更新
  - Cluster Operator のインストールファイルに記載する namespace の更新: 手順では、新しいインストールファイルに Cluster Operator の実行先 namespace を反映するよう案内しています。また、Linux と macOS 向けの RoleBinding YAML コマンドも提供しています。
  - クラスターオペレーターの Deployment で変更済み環境変数を使用: 手順では、変更済みの環境変数を使用するために `060-Deployment-strimzi-cluster-operator.yaml` を編集します。
  - 複数の namespace を監視する Cluster Operator デプロイメントのロールバインディング更新
  - すべての namespace の監視に伴うクラスタ全体のロールバインディングの再作成: 手順では、必要に応じてクラスタ全体へのアクセス権を付与するバインディングを再作成します。
  - Cluster Operator のアップグレード時にインストールリソースとともに更新済み設定をデプロイ: 更新済みの設定をほかのインストールリソースとともにデプロイした後、ローリングアップデートが完了するまで待機する手順です。
  - 非サポートの Kafka バージョンからのアップグレード時のエラー報告
  - オペレーターのアップグレード時にサポート対象外の Kafka バージョンに遭遇した場合の手順: オペレーターのアップグレード時に、オペレーターがサポートしていない Kafka バージョンに遭遇した場合は、`spec.kafka.version` をサポート対象のバージョンに変更する手順が示されています。
  - Cluster Operator のアップグレード後に可能な Kafka バージョンのアップグレード: サポート対象外の Kafka バージョンに関するエラーが返されない場合、手順に従ってアップグレードを続行できます。
  - OperatorHub.io からのアップグレードに伴う OLM による Strimzi Operator の更新チャネル変更
  - 安定チャネルの自動更新でインストール前のアップグレード手順が適用されない可能性: チャネルを変更しなくても更新が適用されることがあります。自動更新はバージョン固有のチャネルのみを対象として想定されています。
  - OperatorHub を使用した Operator のアップグレードに関する Operator Lifecycle Manager のドキュメント
  - Helm チャートのアップグレード後に必要な CRD の手動更新: `helm upgrade` コマンドでは CRD は更新されません。新しい CRD は GitHub のリリースページ、または Helm チャートの crd サブディレクトリから入手できます。
  - Cluster Operator のアップグレード時の Kafka バージョン互換性: この状況で Cluster Operator をアップグレードすると、サポート対象外の Kafka バージョンエラーが発生します。Kafka は `spec.kafka.version` を変更してアップグレードする必要があります。注記には、Kafka リソースの状態条件を確認するための `kubectl` コマンドと、そのプレースホルダーの説明も記載されています。
  - KRaftベースのアップグレードサポートに関する Apache Kafka のドキュメント
  - アップグレード前の Kafka 設定互換性チェック: アップグレード前に、Kafka リソースにアップグレード先の Kafka バージョンでサポートされていない設定項目が含まれていてはいけません。
  - Kafka メタデータバージョンの互換性チェック: 設定値は、対象の Kafka バージョンでサポートされている必要があります。`spec.kafka.metadataVersion` が設定されていない場合、Strimzi は Kafka バージョンの更新後に、現在のデフォルト値へ更新します。
  - `metadataVersion` を文字列のまま保持するためのガイド
  - Kafka のアップグレード手順で `metadataVersion` を現在の Kafka バージョンのデフォルトに維持: この手順では `Kafka.spec.kafka.version` をアップグレード先のバージョンに設定し、ブローカーを新しいバイナリーにアップグレードします。アップグレード中も、ブローカーとコントローラーは通信できます。
  - 新しい Kafka バージョン向けの Kafka イメージ: `Kafka.spec.kafka.image` が定義されている場合は、新しい Kafka バージョンのイメージに更新する手順となっています。
  - アップグレード手順における Kafka Connect と MirrorMaker のバージョンプロパティ
  - 最新の Strimzi ベースイメージを使ったカスタムイメージの再ビルドが必要
  - 手動ビルドした Kafka Connect イメージ向けの Dockerfile 更新: Dockerfile では、最新のベースイメージとビルド設定を指定する必要があります。
  - `metadataVersion` の引き上げによる Kafka のダウングレードへの影響: 新しい `metadataVersion` がダウングレード先のバージョンより高い場合、ダウングレードできない可能性があります。古い Kafka バージョンを維持すると、サポートや互換性にも影響する場合があります。
  - Kafka クライアントの更新と互換性確認: Kafka のアップグレードに伴い、すべての Kafka クライアントアプリケーションを新しいクライアントバイナリのバージョンに更新し、互換性を確認する必要があります。これらのアプリケーションを管理するチームとの調整が必要になる場合があります。
  - ZooKeeper ベースの Kafka クラスターのアップグレード要件: これらのクラスターをアップグレードするには、Kafka のバージョンとブローカー間プロトコルのバージョンの両方を更新する必要があります。
  - ZooKeeper から KRaft への移行ガイダンス: KRaft モードへの切り替えは、Kafka のアップグレードとは別に行う必要があります。
  - ZooKeeper 管理下のアップグレードにおける Kafka バージョンとブローカー間プロトコルの更新: Kafka リソースで Kafka のバージョンと互換性のあるブローカー間プロトコルのバージョンを更新します。プロトコルは `Kafka.spec.kafka.config` を通じてクラスター全体に設定します。
  - アップグレード時の Kafka メッセージ形式設定: Kafka 3.0.0 以降では、メッセージ形式のバージョンは `inter.broker.protocol.version` と同じものとみなされます。このプロトコルバージョンを更新する際はメッセージ形式の設定を削除できます。それ以外の場合は、更新先の Kafka バージョンを設定できます。トピックのデフォルトのメッセージ形式はブローカーの `log.message.format.version` から引き継がれますが、トピックごとに独自の値を設定することもできます。
  - Kafka メッセージ形式バージョンプロパティの非推奨化: この構成では、`log.message.format.version` は無視されるため、設定する必要はありません。
  - Kafka メッセージ形式オーバーライドの移行ガイダンス: Kafka 3.0 より前は、オーバーライドによって古いクライアントに対応できました。オーバーライドがない場合、ブローカーは古い形式のメッセージを変換するため、大幅なパフォーマンス低下が生じます。ブローカーのアップグレード時にオーバーライドを削除する場合、リリースノートでは、まずコンシューマーをアップグレードし、次にプロデューサーをアップグレードすることを推奨しています。Apache Kafka Java クライアントは、0.11 以降、最新のメッセージ形式をサポートしています。
  - Kafka のアップグレード要件: Cluster Operator が稼働しており、Kafka リソースにアップグレード先の Kafka バージョンでサポートされない設定オプションが含まれていない必要があります。
  - プロトコルバージョンとメッセージ形式バージョンの Kafka アップグレード時の注意: Kafka 3.8.0 から 3.9.1 へアップグレードする場合は、Kafka のバージョンを変更する前に、設定済みの `inter.broker.protocol.version` と `log.message.format.version` を `3.8` に保ってください。これらの設定がない場合、Kafka のバージョン変更後に Strimzi が現在のデフォルト値に更新します。
  - `log.message.format.version` と `inter.broker.protocol.version` に文字列値が必要: 文字列値でない場合、これらの値が浮動小数点数として解釈される可能性があります。
  - Kafka アップグレード時のプロトコル設定における現行バージョンの既定値維持: 3.8.0 から 3.9.1 へのアップグレードでは、ブローカーが新しいバイナリへ順次切り替わる間、両方の設定は `3.8` のままです。ロールアウト中は旧バイナリと新バイナリが同時に稼働し、インターブローカープロトコルが変更されないため、引き続き通信できます。
  - `inter.broker.protocol.version` の変更後における Kafka のダウングレード非互換性: アップグレード後、ダウングレードしたクラスターは、`__consumer_offsets` に書き込まれたメッセージを含む、結果として生成される永続メタデータのスキーマを理解できません。
  - 手動ビルドしたカスタムイメージに必要な最新の Strimzi ベースイメージ: 再ビルドするには、Dockerfile のベースイメージとビルド設定を更新する必要があります。
  - ブローカー間プロトコルバージョンの更新に関する案内: Kafka 3.9.1 の例では、`inter.broker.protocol.version` を `3.9` に設定し、`log.message.format.version` は `3.8` のままにしています。
  - Kafka のアップグレードにおけるバージョン設定の前提条件: この手順では、`log.message.format.version` を新しいバージョンに更新し、Cluster Operator がクラスターを更新するまで待ちます。Kafka 3.9.1 の場合、例では `log.message.format.version` と `inter.broker.protocol.version` の両方を `3.9` に設定します。
  - FIPS 手順の前提条件
  - Kafka クラスターでの FIPS モード有効化: 手順では、`FIPS_MODE` を無効にしたまま Cluster Operator を 0.33 以降にアップグレードし、必要に応じてクラスター CA とクライアント CA の証明書を更新します。Cluster Operator が生成した CA には `force-renew` を使用します。独自の CA を使用している場合は、CA シークレットを更新し、`ca-cert-generation` の値を増やします。パスワードが 32 文字未満の SCRAM-SHA-512 ユーザーは、新しいパスワードをクライアント側にも反映する必要があります。証明書とパスワードが要件を満たした後、`FIPS_MODE` を削除すると Cluster Operator が再起動し、すべてのオペランドがロールアウトされます。

## セキュリティ (2)

### Jetty の URI 解析と gzip バッファ解放の不具合への対処

- 影響対象: バンドルされた Jetty コンポーネントを使用する Strimzi インストール (推定)
- [CVE-2024-13009](https://www.cve.org/CVERecord?id=CVE-2024-13009), [CVE-2024-6763](https://www.cve.org/CVERecord?id=CVE-2024-6763)

このリリースより前は、`HttpURI` が不正な URI authority をブラウザーとは異なる方法で検証する可能性がありました。また、リクエスト本文の展開中に gzip エラーが発生すると、バッファが誤って解放され、リクエスト間でデータが破損したり共有されたりする可能性がありました。Strimzi は Jetty 9.4.57.v20241219 を使用するようになりました。プルリクエストによると、この更新は両方の問題への対処を意図したものです。

> * Bump jetty to address CVE-2024-6763 and CVE-2024-13009 by @fvaleri in https://github.com/strimzi/strimzi-kafka-operator/pull/11536

### `json-smart` のスタック枯渇の問題を修正

- 影響対象: Strimzi cluster operator または Kafka 3.8.x/3.9.x のサードパーティライブラリーを使用するインストール環境
- 追加の対応: 手動で作成した `JSONParser` インスタンスまたはカスタムパーサーオプション向けの `LIMIT_JSON_DEPTH`
- [CVE-2024-57699](https://www.cve.org/CVERecord?id=CVE-2024-57699)

`json-smart` 2.5.0から2.5.1では、多数の開始波括弧を含む細工された JSON によってスタックが枯渇し、サービス拒否が発生する可能性がありました。Strimzi は cluster operator と Kafka 3.8.x/3.9.x のサードパーティライブラリーで `json-smart` 2.5.2 を使用するようになり、`MODE_RFC4627` などの `JSONParser` のデフォルトモードでこの問題が修正されました。

> * Added json-smart 2.5.2 as dependency to fix CVE-2024-57699 on 0.45.x release branch by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11411
> * Fixed CVE-2024-57699 by overriding json-smart dependency with 2.5.2 version.

## 破壊的変更 (3)

### Kafka 3.9.1 のサポート対象デフォルトへの追加

- 影響対象: デフォルトバージョンを使用するか、Kafka 3.9.1 を使用するよう設定された Kafka リソース (推定)

根拠: “This PR adds support for Kafka 3.9.1 to Strimzi.” https://github.com/strimzi/strimzi-kafka-operator/pull/11364

> * Add support for Kafka 3.9.1 by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11364

### リリース候補の Sonatype への直接公開

- 影響対象: Sonatype または OSS staging リポジトリーから利用する Strimzi のリリース候補アーティファクト (推定)

これまではリリース候補をステージングリポジトリー経由で公開していましたが、このリリースでは Sonatype に直接公開します。

根拠: “As there is no staging repository in new Sonatype portal, we decided to release RCs directly into the repository and not using any other staging repository.” https://github.com/strimzi/strimzi-kafka-operator/pull/11508

> * [release-0.45.x] Release RC artifacts directly to Sonatype by @im-konge in https://github.com/strimzi/strimzi-kafka-operator/pull/11508

### Topic Operatorの一方向管理への移行

- 影響対象: Bidirectional Topic Operatorを使用するStrimziバージョンからアップグレードするTopic Operator環境
- 必要な対応: Cluster Operatorのアップグレード後、`strimzi-store-topic` と `strimzi-topic-operator` を管理する `KafkaTopic` リソースを削除。Kafka内の `consumer-offsets` と `transaction-state` は保持し、それらの `KafkaTopic` リソースに `strimzi.io/managed="false"` を付与。調整により管理対象外になったことを確認後、それらのリソースを削除

従来、Topic OperatorはKafkaクラスター内のトピックに対する操作も実行できましたが、現在は独立して管理されているトピックには手を加えません。

> When deploying the Topic Operator to manage topics, the Cluster Operator enables unidirectional topic management.
> This means that the Topic Operator only manages Kafka topics associated with KafkaTopic resources and does not interfere with topics managed independently within the Kafka cluster.
> Previously, the Topic Operator worked in bidirectional mode, which meant it could also perform operations on topics within the Kafka cluster.

https://strimzi.io/docs/operators/0.45.1/deploying.html

## 重大な修正 (3)

### ロールバック後の KRaft 移行で発生するメタデータ消失の修正

- 影響対象: KRaft 移行

以前のロールバック後に KRaft 移行を再開すると、`/migration` znode が削除されていないため、クラスターのメタデータが失われることがありました。

> * Fixed bug which may lead to metadata loss within the cluster when restarting a KRaft migration after a previous rollback due to missing `/migration` znode deletion.

### MirrorMaker 2 の追加ボリューム処理の修正

- 影響対象: MirrorMaker 2 のテンプレートで追加ボリュームを使用する Strimzi 環境 (推定)

生成される Pod に、設定した ConfigMap および PVC のボリュームと、それらのマウントが含まれるようになりました。

> * Cherry-pick OPA and Additional Volumes in MM2 fixes to 0.45 release branch by @scholzj in https://github.com/strimzi/strimzi-kafka-operator/pull/11030

### KRaft 移行のロールバック時のクリーンアップ修正

- 影響対象: KRaft 移行を使用するクラスター (推定)

ロールバック後に `/migration` znode を削除せずに KRaft 移行を再開すると、最初の ZooKeeper から KRaft への同期が省略され、メタデータが失われる可能性がありました。ロールバック時のクリーンアップでこの znode を削除し、移行状態をリセットするようになりました。これにより、後続の移行で最初の同期が実行されます。

> * Fixed missing deletion of the migration znode on KRaft migration rollback by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11271

## 機能・改善 (3)

- Kafka 3.9.1 のサポート
- Kafka Connect の Kaniko ビルドでの `--ignore-path` の指定対応 (利用条件: `additionalKanikoOptions` に `--ignore-path` を指定)
- 公開される Strimzi Maven POM へのプロジェクト名の追加

## 依存関係の更新 (8)

ほか8件（いずれもセキュリティへの言及なし）

- `* Dependency updates (Vert.x 4.5.13, Netty 4.1.118.Final).`
- `* Cherry-pick bumped Vert.x 4.5.12 and Netty 4.1.117.Final to 0.45.x release branch by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11079`
- `* Cherry-pick update Fabric8 Kubernetes Client to 7.1.0 to 0.45.x release branch by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11265`
- `* Chery-pick Update Vert.x to 4.5.13 to 0.45.x release branch by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11266`
- `* Chery-pick Update Fabric8 Kubernetes Client to 7.2.0 to 0.45.x release branch by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11395`
- `* [release-0.45.x] Bump test-containers to 0.109.2 by @im-konge in https://github.com/strimzi/strimzi-kafka-operator/pull/11547`
- `* [release-0.45.x] Bumped OAuth 0.15.1 by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11545`
- `* Updated bridge to 0.31.2 by @ppatierno in https://github.com/strimzi/strimzi-kafka-operator/pull/11564`

## その他の変更 (10)

- OPA システムテスト用フィクスチャーの更新
- 0.45.1 の変更履歴セクション初版
- コントローラーノードプールの PVC 削除に伴う移行ロールバックのドキュメント
- KRaft 移行のロールバック時のクリーンアップに関するドキュメント
- KRaft へのロールバックと完全移行のシステムテスト追加
- CodeQL ワークフローの `actions/cache` プラグインの v4.2.1 への更新
- 0.45.x Maven POM から Apache Kafka のステージングリポジトリを削除
- 0.45.x リリースの成果物公開先を Sonatype Central に移行
- 本番環境向けの専用ブローカーおよびコントローラーノードに関するドキュメント
- デュアルロールノードとシングルロールノードの併用に関するドキュメント

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
