Red Hat Summit1.5. Apicurio Registry デプロイメントのアップグレードと移行
OpenShift では、Apicurio Registry サーバーを Apicurio Registry 2.x から Apicurio Registry 2.4 に自動的にアップグレードできます。Apicurio Registry 1.x から Apicurio Registry 2.x への自動アップグレードはなく、移行プロセスが必要です。
1.5.1. 2.x クライアントの依存関係の更新
このリリースではクライアントの依存関係を更新することは必須ではありません。既存の 2.x クライアントは引き続き Apicurio Registry 2.4 で動作します。
ただし、Apicurio Registry の次のリリースの前に、最新の Apicurio Registry クライアントバージョンを使用するようにクライアントアプリケーションの依存関係をすべて更新する必要があります。クライアントアプリケーションの依存関係には、Kafka シリアライザー/デシリアライザー (SerDes)、Maven プラグイン、および Java REST クライアントの依存関係が含まれます。たとえば、Java REST クライアントの Maven 依存関係を更新するには、次のように pom.xml ファイルでバージョンを指定します。
<dependency>
<groupId>io.apicurio</groupId>
<artifactId>apicurio-registry-client</artifactId>
<version>2.4.4.SP1-redhat-00001</version>
</dependency>詳細は、デフォルトで有効になっているレガシー REST API の日付形式 を参照してください。
1.5.2. OpenShift での Apicurio Registry 2.x からのアップグレード
OpenShift 4.9 の Apicurio Registry 2.x から OpenShift 4.10 以降の Apicurio Registry 2.4 にアップグレードできます。Apicurio Registry と OpenShift の両方のバージョンをアップグレードし、OpenShift のマイナーバージョンを 1 つずつアップグレードする必要があります。
前提条件
- すでに OpenShift 4.9 に Apicurio 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 がデプロイされ、Apicurio Registry Pod がデプロイされるまで待ちます。
- Apicurio Registry システムが稼働中であることを確認します。
関連情報
- OpenShift Container Platform Web コンソールで Operator 更新チャネルを設定する方法の詳細は、Operator の更新チャネルの変更 を参照してください。
1.5.3. OpenShift 上の Apicurio Registry 1.1 からの移行
Apicurio Registry 1.1 から Apicurio Registry 2.x への移行の詳細は、Apicurio Registry デプロイメントの Red Hat ビルドの移行 を参照してください。
