25.5. Cluster Operator のアップグレード

手順

1. 既存の Cluster Operator リソース (/install/cluster-operator ディレクトリー内) に追加した設定変更を書留めておきます。すべての変更は、新しいバージョンの Cluster Operator によって上書きされます。
2. カスタムリソースを更新して、Streams for Apache Kafka バージョン 2.7 で使用できるサポート対象の設定オプションを反映します。

3. Cluster Operator を更新します。

   1. Cluster Operator を実行している namespace に従い、新しい Cluster Operator バージョンのインストールファイルを編集します。

      Linux の場合は、以下を使用します。

      sed -i 's/namespace: .*/namespace: my-cluster-operator-namespace/' install/cluster-operator/*RoleBinding*.yaml

      MacOS の場合は、以下を使用します。

      sed -i '' 's/namespace: .*/namespace: my-cluster-operator-namespace/' install/cluster-operator/*RoleBinding*.yaml

   2. 既存の Cluster Operator Deployment で 1 つ以上の環境変数を編集した場合、install/cluster-operator/060-Deployment-strimzi-cluster-operator.yaml ファイルを編集し、これらの環境変数を使用します。

4. 設定を更新したら、残りのインストールリソースとともにデプロイします。

   oc replace -f install/cluster-operator

   ローリング更新が完了するのを待ちます。

5. 新しい Operator バージョンがアップグレード元の Kafka バージョンをサポートしなくなった場合、Cluster Operator はバージョンがサポートされていないことを示すエラーメッセージを返します。そうでない場合は、エラーメッセージは返されません。

   • エラーメッセージが返される場合は、新しい Cluster Operator バージョンでサポートされる Kafka バージョンにアップグレードします。

     1. Kafka カスタムリソースを編集します。
     2. spec kafka.version プロパティーをサポートされる Kafka バージョンに変更します。
   • エラーメッセージが返されない場合は、次のステップに進みます。Kafka のバージョンを後でアップグレードします。

6. Kafka Pod のイメージを取得して、アップグレードが正常に完了したことを確認します。

   oc get pods my-cluster-kafka-0 -o jsonpath='{.spec.containers[0].image}'

   イメージタグに、新しい Streams for Apache Kafka バージョンと Kafka バージョンが表示されます。

   registry.redhat.io/amq-streams/strimzi-kafka-37-rhel9:2.7.0

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

1. Streams for Apache Kafka 1.7 にアップグレードします。
2. Streams for Apache Kafka 1.8 に付属する Red Hat Streams for Apache Kafka API 変換ツール を、Streams for Apache Kafka ソフトウェアダウンロードページ からダウンロードします。

3. カスタムリソースおよび CRD を v1beta2 に変換します。

   詳細は、Streams for Apache Kafka 1.7 のアップグレードドキュメント を参照してください。

4. OperatorHub で、Streams for Apache Kafka Operator のバージョン 1.7 を削除します。

5. Streams for Apache Kafka Operator のバージョン 2.7 も存在する場合は削除します。

   存在しない場合は、次のステップに進みます。

   Streams for Apache Kafka Operator の Approval Strategy が Automatic に設定されている場合、Operator のバージョン 2.7 がクラスター内にすでに存在している可能性があります。リリース前にカスタムリソースおよび CRD を v1beta2 API バージョンに 変換しなかった 場合、Operator が管理するカスタムリソースおよび CRD は古い API バージョンを使用します。その結果、2.7 Operator は Pending ステータスで停止します。このような場合、Streams for Apache Kafka Operator のバージョン 1.7 だけでなくバージョン 2.7 も削除する必要があります。

   両方の Operator を削除すると、新しい Operator バージョンがインストールされるまで、調整は一時停止されます。カスタムリソースへの変更が遅延しないように、次の手順を直ちに実行します。

6. OperatorHub で、次のいずれかを実行します。

   • Streams for Apache Kafka Operator のバージョン 1.8 (ControlPlaneListener フィーチャーゲートがデフォルトで無効) にアップグレードします。
   • ControlPlaneListener フィーチャーゲートを無効にして、Streams for Apache Kafka Operator のバージョン 2.0 または 2.2 (ControlPlaneListener フィーチャーゲートがデフォルトで有効) にアップグレードします。

7. 速やかに Streams for Apache Kafka Operator のバージョン 2.7 にアップグレードします。

   インストールされた 2.7 Operator はクラスターの監視を開始し、ローリング更新を実行します。このプロセス中に、クラスターのパフォーマンスが一時的に低下する場合があります。