第2章 operator ベースの 3scale のアップグレードガイド: 2.7 から 2.8 へ
本セクションでは、operator ベースのデプロイメントにおいて、Red Hat 3scale API Management をバージョン 2.7 から 2.8 にアップグレードする方法について説明します。
必要な条件および手順を理解するために、記載の手順を適用する前に、アップグレードガイド全体を読んでください。アップグレードプロセスの手順が完了するまで、サービスの提供が中断されます。このサービス中断が生じるため、メンテナンス期間を設けるようにしてください。
前提条件
- 3scale operator によりデプロイされている 3scale 2.7
- OpenShift Container Platform (OCP) 4.x クラスターおよびその管理者アクセス
2.1. 3scale 2.7 から 2.8 へのアップグレード リンクのコピーリンクがクリップボードにコピーされました!
operator ベースのデプロイメントにおいて、3scale をバージョン 2.7 から 2.8 にアップグレードするには、以下の手順を使用します。
手順
- 管理者権限を持つアカウントを使用して OCP コンソールにログインします。
- 3scale-operator がデプロイされているプロジェクトを選択します。
- Operators > Installed Operators の順にクリックします。
- 3scale operator の Subscription > Channel を選択します。
threescale-2.8 を選択してサブスクリプションのチャネルを編集し、変更を保存します。
- これによりアップグレードプロセスが開始されます。
- APIManager のアップグレードプロセスが完了するまで待ちます。
プロジェクトの Pod ステータスのクエリーを行います。
oc get pods
oc get pods
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - すべての新しいバージョンが動作して使用できる状態になり、エラーが無くなるまで待ちます。
アップグレードプロセス中、一時的にエラーが発生する場合があります。
注記所要時間はおよそ 5 - 10 分間の範囲で幅があります。すべての Pod が動作して使用できる状態になり、エラーが無くなるまで、Pod の状態確認を続けてください。
- 3scale 管理ポータルにログインして期待通りに動作することを確認し、アップグレードプロセスが正常に完了したことを確認します。
APIManager オブジェクトのステータスを確認し、以下のコマンドを実行して YAML のコンテンツを取得します。
oc get apimanager <myapimanager> -o yaml
oc get apimanager <myapimanager> -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 新しいアノテーションおよび値は以下のようになります。
apps.3scale.net/apimanager-threescale-version: "2.8" apps.3scale.net/threescale-operator-version: "0.5.0"
apps.3scale.net/apimanager-threescale-version: "2.8" apps.3scale.net/threescale-operator-version: "0.5.0"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 上記の手順をすべて実施すると、operator ベースのデプロイメントにおける 3scale 2.7 から 2.8 へのアップグレードが完了します。