5.3. OperatorHub を使用した Operator のアップグレード

この手順では、OperatorHub を使用して AMQ Broker Operator のインスタンスをアップグレードする方法を説明します。

重要
  • OperatorHub を使用して AMQ Broker Operator をアップグレードするには、OpenShift クラスターのクラスター管理者権限が必要です。
  • OperatorHub を使用して、Operator を AMQ Broker 7.7 の最新バージョンに シームレスに アップグレードできません。代わりに、以下の手順で説明するように、既存の Operator をアンインストールしてから、OperatorHub から最新バージョンをインストールする必要があります。このアップグレードの一環として、プロジェクト内の既存のブローカーデプロイメントを削除してから再作成する必要もあります。
  • Operator のバージョン 0.6 (つまり、AMQ Broker 7.4 で利用可能だったテクニカルプレビューバージョン) をアップグレードする場合、以前にクラスターにデプロイされたカスタムリソース定義 (CRD) も削除してから、Operator の新規インストールを実行する必要があります。これらの手順については、次の手順で説明します。

手順

  1. クラスター管理者として OpenShift Container Platform Web コンソールにログインします。

  2. プロジェクトのブローカーデプロイメントのメインカスタムリソース (CR) インスタンスを削除します。このアクションにより、ブローカーデプロイメントが削除されます。

    1. 左側のナビゲーションメニューで、カスタムリソース定義 をクリックします。
    2. Custom Resource Definitions ページで、ActiveMQArtemis CRD をクリックします。
    3. Instances タブをクリックします。
    4. プロジェクトの namespace に対応する CR インスタンスを見つけます。
    5. CR インスタンスの場合は、右側の More Options アイコン (3 つの点) をクリックします。Delete ActiveMQArtemis を選択します。

  3. プロジェクトから既存の AMQ Broker Operator をアンインストールします。

    1. 左側のナビゲーションメニューで、Operators → Installed Operators をクリックします。
    2. ページ上部の Project ドロップダウンメニューから、Operator をアンインストールするプロジェクトを選択します。
    3. アンインストールする Red Hat Integration - AMQ Broker インスタンスを見つけます。
    4. Operator インスタンスの場合は、右側の More Options アイコン (3 つの点) をクリックします。Uninstall Operator を選択します。
    5. 確認ダイアログボックスで、Uninstall をクリックします。

  4. Operator のバージョン 0.6 (つまり、AMQ Broker 7.4 で利用可能だった Technical Preview バージョン) をアップグレードする場合:

    1. AMQ Broker 7.7 に含まれる最新の CRD にアクセスします。「Operator コードの取得」 を参照してください。

    2. クラスター内の既存の CRD を削除し、最新の CRD を手動でデプロイします。「CLI を使用した Operator のデプロイ」を参照してください。

      注記
      • Operator のバージョン 0.15 (つまり、AMQ Broker 7.7 で利用可能な最初のバージョン)、バージョン 0.13 (つまり、AMQ Broker 7.6 で利用可能なバージョン)、またはバージョン 0.9 (つまり、AMQ で利用可能なバージョン) をアップグレードする場合 Broker 7.5、または AMQ Broker 7.4 で利用可能な長期サポートバージョン) を使用している場合に、Operator Hub から最新の Operator バージョンをインストールすると、Operator Lifecycle Manager (OLM) は OpenShift クラスターの CRD を 自動的に 更新します。既存の CRD を削除する必要はありません。
      • 最新の Operator バージョンの CRD を使用してクラスターを更新する場合、今回の更新はクラスターのすべてのプロジェクトに影響を与えます。以前のバージョンの Operator からデプロイされたブローカー Pod は、OpenShift Container Platform Web コンソールでそれらのステータスを更新できなくなる可能性があります。稼働中のブローカー Pod の Logs タブをクリックしたら、UpdatePodStatus が失敗したことを示すメッセージが表示されます。ただし、そのプロジェクトのブローカー Pod および Operator は予想通りに機能し続けます。影響を受けるプロジェクトに対してこの問題を解決するには、Operator の最新バージョンを使用するようプロジェクトをアップグレードする必要もあります。
  5. OperatorHub を使用して、AMQ Broker 7.7 の Operator の最新バージョンをインストールします。詳細は、「OperatorHub からの Operator のデプロイ」 を参照してください。
  6. 以前のブローカーデプロイメントを再作成するには、メインブローカー CR の新しいインスタンスをプロジェクトにデプロイします。詳細は、「基本的なブローカーインスタンスのデプロイ」 を参照してください。