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

手順

1. 以前の Cluster Operator のインストール時に行われた設定の変更をメモします。

   すべての変更は、新しいバージョンの Cluster Operator によって 上書き されます。

2. カスタムリソースを更新して、Streams for Apache Kafka バージョン 2.9 で使用できるサポート対象の設定オプションを反映します。

3. 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

4. Deployment 設定で環境変数を変更した場合は、その環境変数を使用するように 060-Deployment-strimzi-cluster-operator.yaml ファイルを編集します。

   • Cluster Operator が複数の namespace を監視している場合は、namespace のリストを STRIMZI_NAMESPACE 環境変数に追加します。
   • Cluster Operator がすべての namespace を監視している場合は、STRIMZI_NAMESPACE 環境変数に value: "*" を指定します。

5. Cluster Operator が複数の namespace を監視している場合は、ロールバインディングを更新します。

   • 複数の namespace を監視する場合は、RoleBinding インストールファイル内の namespace を実際の namespace 名に置き換え、それぞれ の namespace のロールバインディングを作成します。

     namespace のロールバインディングの作成

     oc create -f install/cluster-operator/020-RoleBinding-strimzi-cluster-operator.yaml -n <watched_namespace>
     oc create -f install/cluster-operator/023-RoleBinding-strimzi-cluster-operator.yaml -n <watched_namespace>
     oc create -f install/cluster-operator/031-RoleBinding-strimzi-cluster-operator-entity-operator-delegation.yaml -n <watched_namespace>

     Copy to Clipboard Toggle word wrap

     たとえば、Cluster Operator が 3 つの namespace を監視している場合は、<watched_namespace> を各 namespace の名前に置き換えて、3 セットのロールバインディングを作成します。

   • すべての namespace を監視する場合は、クラスター全体のアクセスを許可するクラスターロールバインディングを再作成します (必要な場合)。

     ロールバインディングを使用してクラスター全体のアクセスを許可する

     oc create clusterrolebinding strimzi-cluster-operator-namespaced --clusterrole=strimzi-cluster-operator-namespaced --serviceaccount my-cluster-operator-namespace:strimzi-cluster-operator
     oc create clusterrolebinding strimzi-cluster-operator-watched --clusterrole=strimzi-cluster-operator-watched --serviceaccount my-cluster-operator-namespace:strimzi-cluster-operator
     oc create clusterrolebinding strimzi-cluster-operator-entity-operator-delegation --clusterrole=strimzi-entity-operator --serviceaccount my-cluster-operator-namespace:strimzi-cluster-operator

     Copy to Clipboard Toggle word wrap

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

   oc replace -f install/cluster-operator

   Copy to Clipboard Toggle word wrap

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

7. 新しい Operator バージョンが、アップグレード元の Kafka バージョンをサポートしなくなった場合は、エラーメッセージが返されます。

   これを解決するには、サポートされている Kafka バージョンにアップグレードします。

   1. Kafka カスタムリソースを編集します。
   2. spec kafka.version プロパティーをサポートされる Kafka バージョンに変更します。

   エラーメッセージが返されない場合は、次のステップに進み、後で Kafka バージョンをアップグレードできます。

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

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

   Copy to Clipboard Toggle word wrap

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

   registry.redhat.io/amq-streams/strimzi-kafka-39-rhel9:2.9.3

   Copy to Clipboard Toggle word wrap

   また、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.9 も存在する場合は削除します。

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

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

   両方の 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.9 にアップグレードしてください。

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