6.5. Service Registry デプロイメントのアップグレードと移行
OpenShift では、Service Registry サーバーを Service Registry 2.x から Service Registry 2.4 に自動的にアップグレードできます。Service Registry 1.x から Service Registry 2.x への自動アップグレードはなく、移行プロセスが必要です。
6.5.1. 2.x クライアントの依存関係の更新
このリリースではクライアントの依存関係を更新することは必須ではありません。既存の 2.x クライアントは引き続き Service Registry 2.4 で動作します。
ただし、Service Registry の次のリリースの前に、クライアントアプリケーションのすべての依存関係を、最新の Service Registry クライアントバージョンを使用するように更新する必要があります。クライアントアプリケーションの依存関係には、Kafka シリアライザー/デシリアライザー (SerDes)、Maven プラグイン、および Java REST クライアントの依存関係が含まれます。たとえば、Java REST クライアントの Maven 依存関係を更新するには、次のように pom.xml ファイルでバージョンを指定します。
<dependency>
<groupId>io.apicurio</groupId>
<artifactId>apicurio-registry-client</artifactId>
<version>2.4.3.Final-redhat-00006</version>
</dependency>詳細は、デフォルトで有効になっているレガシー REST API の日付形式 を参照してください。
6.5.2. OpenShift での Service Registry 2.x からのアップグレード
Service Registry 2.x on OpenShift 4.9 から Service Registry 2.4 on OpenShift 4.10 以降にアップグレードできます。Service Registry と OpenShift の両方のバージョンをアップグレードし、OpenShift のマイナーバージョンを 1 つずつアップグレードする必要があります。
前提条件
- すでに OpenShift 4.9 に Service Registry 2.x がインストールされている。
手順
- OpenShift Container Platform Web コンソールで、Administration をクリックしてから Cluster Settings をクリックします。
-
Channel フィールドの横にある鉛筆アイコンをクリックし、次のマイナー
candidateバージョンを選択します (たとえば、stable-4.9からcandidate-4.10に変更します)。 - Save をクリックしてから Update をクリックし、アップグレードが完了するまで待ちます。
-
OpenShift のバージョンが 4.11 未満の場合は、手順 2 と 3 を繰り返し、
candidate-4.11以降を選択します。 - Operators > Installed Operators > Red Hat Integration - Service Registry をクリックします。
-
Update channel が
2.xに設定されていることを確認します。 -
Update approval が Automatic に設定されている場合は、
2.xチャネルが設定された直後にアップグレードを承認してインストールする必要があります。 - Update approval が Manual に設定されている場合は、Install をクリックします。
- Operator がデプロイされ、Service Registry Pod がデプロイされるまで待ちます。
- Service Registry システムが稼働中であることを確認します。
関連情報
- OpenShift Container Platform Web コンソールで Operator 更新チャネルを設定する方法の詳細は、Operator の更新チャネルの変更 を参照してください。
6.5.3. OpenShift での Service Registry 1.1 からの移行
Service Registry 1.1 から Service Registry 2.x に移行する方法の詳細は、Service Registry デプロイメントの移行 を参照してください。