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 がインストールされている。

手順

  1. OpenShift Container Platform Web コンソールで、Administration をクリックしてから Cluster Settings をクリックします。
  2. Channel フィールドの横にある鉛筆アイコンをクリックし、次のマイナー candidate バージョンを選択します (たとえば、stable-4.9 から candidate-4.10 に変更します)。
  3. Save をクリックしてから Update をクリックし、アップグレードが完了するまで待ちます。
  4. OpenShift のバージョンが 4.11 未満の場合は、手順 2 と 3 を繰り返し、candidate-4.11 以降を選択します。
  5. Operators > Installed Operators > Red Hat Integration - Service Registry をクリックします。
  6. Update channel2.x に設定されていることを確認します。
  7. Update approvalAutomatic に設定されている場合は、2.x チャネルが設定された直後にアップグレードを承認してインストールする必要があります。
  8. Update approvalManual に設定されている場合は、Install をクリックします。
  9. Operator がデプロイされ、Service Registry Pod がデプロイされるまで待ちます。
  10. Service Registry システムが稼働中であることを確認します。

関連情報

6.5.3. OpenShift での Service Registry 1.1 からの移行

Service Registry 1.1 から Service Registry 2.x に移行する方法の詳細は、Service Registry デプロイメントの移行 を参照してください。