第5章 Operator ベースのブローカーデプロイメントのアップグレード

本セクションの手順では、アップグレードする方法を説明します。

  • OpenShift コマンドラインインターフェイス (CLI) と OperatorHub の両方を使用した AMQ Broker Operator バージョン
  • Operator ベースのブローカーデプロイメント用のブローカーコンテナーイメージ
注記

  • OpenShift Container Platform 3.11 で既存の AMQ Broker デプロイメントを OpenShift Container Platform 4.1 以降で実行するには、既存のデプロイメントに一致する AMQ Broker をクリーンインストールする前に、まず OpenShift Container Platform インストールをアップグレードする必要があります。AMQ Broker をクリーンインストールするには、以下のいずれかの方法を使用します。

  • 以下の手順では、マイナー バージョン間でイメージ仕様を手動でアップグレードする方法を説明します (例: 7.x から 7.y)。イメージ仕様で 7.y などの Floating タグを使用する場合、StatefulSet または DeploymentConfig の imagePullPolicy 属性が Always に設定されていると、デプロイメントは、新しい micro イメージバージョン (7.y-z) が利用できるように 自動的 にプルし、使用します。

    たとえば、デプロイメントの image 属性が 7.7 の Floating タグを指定するとします。デプロイメントで現在マイナーバージョン 7.7-2 を使用し、新しいマイナーバージョン 7.7-3 がレジストリーで利用可能な場合に、デプロイメントは新しいマイナーバージョンを自動的にプルし、これを使用します。新しいイメージを使用するには、デプロイメントの各ブローカー Pod が再起動します。デプロイメントに複数のブローカーがある場合、ブローカー Pod は一度に 1 つずつ再起動されます。

5.1. テクニカルプレビューベースのデプロイメントのアップグレードについて

AMQ Broker 7.4.0 で最初に利用可能になった AMQ Broker Operator のバージョン 0.6 は、テクニカルプレビュー機能のみでした。このバージョンの Operator に基づいてブローカーデプロイメントのブローカーコンテナーイメージまたは Operator バージョンをアップグレードする場合は、以下のリストにいくつかの重要な考慮事項が記載されています。

  • Operator のバージョン 0.6 は、AMQ Broker 7.7 の最新バージョンを含む新しいバージョンに直接アップグレード できません。バージョン 0.6 で使用されるカスタムリソース定義 (CRD) は、それ以降のバージョンの Operator と互換性がありません。Operator をバージョン 0.6 からアップグレードするには、Operator の新規インストールを実行する前に、以前にデプロイされた CRD を削除する必要があります。Operator の新しいバージョンをインストールしたら、ブローカーデプロイメントを再作成する必要があります。Operator の最新バージョンをインストールする方法については、「CLI を使用した Operator のインストール」 を参照してください。
  • 最新の Operator バージョンの CRD を使用してクラスターを更新する場合、今回の更新はクラスターのすべてのプロジェクトに影響を与えます。バージョン 0.6 の Operator から過去にデプロイされたブローカー Pod は、ステータスを更新できなくなります。OpenShift Container Platform Web コンソールで実行中のブローカー Pod の Logs タブをクリックすると、UpdatePodStatus が失敗したことを示すメッセージが表示されます。ただし、そのプロジェクトのブローカー Pod および Operator は予想通りに機能し続けます。影響を受けるプロジェクトに対してこの問題を解決するには、Operator の最新バージョンを使用するようプロジェクトをアップグレードする必要もあります。
  • 「ブローカーコンテナーイメージのアップグレード」 は、Operator ベースのデプロイメントの ブローカーコンテナーイメージ をアップグレードする方法を示しています。この手順は、Operator のバージョン 0.13 を使用して以前のデプロイメントを作成していることを前提としています。同様の手順を使用して、Operator のバージョン 0.6 に基づくデプロイメントのブローカーコンテナーイメージをアップグレードできます。バージョン 0.6 に含まれるメインブローカーのカスタムリソース (CR) インスタンスは、broker_v1alpha1_activemqartemis_cr.yaml でした。