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

1. AMQ Streams 1.7 にアップグレードします。
2. AMQ Streams ソフトウェアのダウンロードページ から、AMQ Streams 1.8 で提供される Red Hat AMQ Streams API Conversion Tool をダウンロードします。

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

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

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

5. AMQ Streams Operator のバージョン 2.5 も存在する場合は、削除します。

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

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

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

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

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

7. AMQ Streams Operator のバージョン 2.5 にすぐにアップグレードしてください。

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

手順

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

3. Cluster Operator を更新します。

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

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

   oc replace -f install/cluster-operator

   Copy to Clipboard Toggle word wrap

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

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}'

   Copy to Clipboard Toggle word wrap

   イメージタグには、新しい Operator のバージョンが表示されます。以下に例を示します。

   registry.redhat.io/amq-streams/strimzi-kafka-35-rhel8:2.5.1

   Copy to Clipboard Toggle word wrap