OpenShift Data Foundationのリージョン間災害復旧環境のアップグレード

仮想プライベートクラウド 4.21 そしてその後

Red Hat OpenShift on IBM Cloud、Advanced Cluster Management (ACM) アドオン、ODF、および ODF-DR オペレーターなど、 OpenShift Data Foundation (ODF) リージョナル・ディザスタ・リカバリ (RDR) 環境のコンポーネントを、いつ、どのようにアップグレードするかを学びます。

開始前に

Red Hat OpenShift on IBM Cloud、ACM、またはODFの新しいバージョンがリリースされた場合、あるいはいずれかのコンポーネントが古くなったり、サポート終了が近づいたりした場合は、ODF-RDR環境をアップグレードしてください。 アップグレードを行わない場合、将来的にサービス停止が発生する可能性があります。

作業を開始する前に、3つのコンポーネントすべてのアップグレード版が利用可能になるまでお待ちください。 これにより、アップグレードにかかる総工数を削減できます。

ハブクラスタのアップグレード

ハブクラスタ

アドオンをアップグレードする前に、ハブクラスタのコントロールプレーンおよびワーカーノードの両方をアップグレードしてください。

この手順でコマンドを実行する前に、CLIのコンテキストをハブクラスターに設定してください。

ibmcloud oc cluster config --cluster HUB_CLUSTER_NAME --admin
  1. クラスタのマスターをターゲットバージョンに更新してください。
    ibmcloud oc cluster master update --cluster CLUSTER_NAME --version VERSION
  2. 数分待ってから、マスターの更新が完了したことを確認してください。
    ibmcloud oc cluster ls
  3. ワーカーノードの一覧を表示し、更新対象となる各ノードのIDを確認してください。
    ibmcloud oc worker ls --cluster CLUSTER_NAME
  4. 各ワーカーノードを置き換え、マスターと同じバージョンに更新してください。 各ワーカーノードについて、この操作を繰り返します。
    ibmcloud oc worker replace --cluster CLUSTER_NAME --worker WORKER_NODE_ID --update
  5. すべてのワーカーノードが対象バージョンを実行しており、「 Ready 」ステータスを表示していることを確認してください。 これには数分かかる場合があります。
    ibmcloud oc worker ls --cluster CLUSTER_NAME

マネージドクラスタのアップグレード

マネージドクラスタ

この手順でコマンドを実行する前に、CLIのコンテキストを、アップグレード対象のマネージドクラスターに設定してください。 管理対象のクラスターごとにこの手順を繰り返します。

ibmcloud oc cluster config --cluster MANAGED_CLUSTER_NAME --admin

マネージド・クラスタではODFが実行されているため、 Red Hat OpenShift on IBM Cloud およびODFの両方のアップグレード手順を網羅した、ODF対応ノードのアップグレード手順に従ってください。 詳細な手順については、「 ODF を使用する VPC ワーカーノードの更新または交換 」を参照してください。

ハブクラスタ上のACMのアップグレード

ハブクラスタ

すべてのクラスタが対象の Red Hat OpenShift on IBM Cloud バージョンを実行していることを確認した後、ハブクラスタ上のACMアドオンをアップグレードしてください。

この手順でコマンドを実行する前に、CLIのコンテキストをハブクラスターに設定してください。

ibmcloud oc cluster config --cluster HUB_CLUSTER_NAME --admin
  1. ACMアドオンをターゲットバージョンにアップグレードしてください。 「 CLUSTER_NAME 」をハブクラスタの名前に、「 VERSION 」をターゲットとなる ACM のバージョン（例： 2.16 ）に置き換えてください。
    ibmcloud oc cluster addon update acm --cluster CLUSTER_NAME --version VERSION
  2. アドオンが正常に更新されたことを確認してください。 出力結果で、ACMアドオンにターゲットバージョンが表示されていることを確認してください。
    ibmcloud oc cluster addon ls --cluster CLUSTER_NAME

ハブクラスタ上の ODF マルチクラスタ・オーケストレーターのアップグレード

ハブクラスタ

管理対象のすべてのクラスタで ODF のアップグレードが完了したら、ハブクラスタ上の ODF Multicluster Orchestrator をアップグレードしてください。

「 OpenShift 」DRハブオペレーターおよび「 OpenShift 」DRクラスターオペレーターは、ODFマルチクラスターオーケストレーターの依存関係としてインストールされ、自動的にアップグレードされます。 手動でアップグレードする必要はありません。

  1. ODF Multicluster Orchestrator オペレーターの現在のサブスクリプション・チャネルを確認してください。

    oc get subscription.operators.coreos.com odf-multicluster-orchestrator -n openshift-operators -o jsonpath='{.spec.channel}'

  2. 管理対象クラスターでアップグレードしたODFのバージョンに合わせて、サブスクリプションチャンネルのバージョンを更新してください。 このチャンネルの形式は「 stable-X.Y 」となっており、ここで「 X.Y 」はODFのバージョンを表します。 たとえば、ODFを 4.21 にアップグレードした場合は、 stable-4.21 を使用してください。

    ODF Multicluster Orchestrator のバージョンは、管理対象クラスタにインストールされている ODF のバージョンと一致している必要があります。 バージョンが一致しないものを使用すると、DRポリシーの検証に失敗する可能性があります。

    利用可能なチャンネルを確認するには、次のコマンドを実行してください。

    oc get packagemanifest odf-multicluster-orchestrator -n openshift-marketplace -o jsonpath='{.status.channels[*].name}'

    次に、サブスクリプションをターゲットチャンネルにパッチ適用します。 stable-4.21 を、お使いの ODF バージョンに対応するチャンネルに置き換えてください。

    oc patch subscription.operators.coreos.com odf-multicluster-orchestrator -n openshift-operators \
  --type merge -p '{"spec":{"channel":"stable-4.21"}}'

  3. 新バージョンの導入計画が作成されていることを確認してください。

    oc get installplan -n openshift-operators

    対象バージョンのインストール計画に「 APPROVED: false 」と表示されている場合、アップグレードを進める前に手動で承認する必要があります。 「 INSTALLPLAN_NAME 」を、対象バージョンのインストールプラン名に置き換えてください。

    oc patch installplan INSTALLPLAN_NAME -n openshift-operators --type merge -p '{"spec":{"approved":true}}'

  4. 対象バージョンの CSV で、ステータスが「 Succeeded 」となっていることを確認してください。

    oc get csv -n openshift-operators | grep odf-multicluster

  5. ODF Multicluster Orchestrator のオペレーターポッドが、 openshift-operators ネームスペースで実行されていることを確認してください。

    oc get pods -n openshift-operators | grep -i odf

    odf-multicluster-console と odfmo-controller-manager の両方のポッドが、 Running というステータスを示していることを確認してください。

  6. 照合後に、 DRPolicy が検証済みであることを確認してください。

    oc get drpolicy -A

    「 VALIDATED 」列に、すべてのポリシーについて「 True 」と表示されていることを確認してください。 そうでない場合は、次のコマンドを実行してステータスを確認してください。

    oc describe drpolicy <drpolicy_name>

  7. MirrorPeer の照合が完了したことを確認してください。

    oc get mirrorpeers -A

    Phase に「 ExchangedSecret 」と表示されていることを確認してください。 「 ExchangingSecret 」と表示された場合は、続行する前にサブマリーナーの接続状態を確認してください。

詳細については、『 Red Hat 』のドキュメントにある「 ODF Multicluster Orchestrator のインストール 」を参照してください。

オプション演算子のアップグレード

お使いの環境に以下のオペレータが含まれている場合は、ODF-DRオペレータのアップグレード後に、それらをアップグレードしてください。

GitOps
詳細については、『 Red Hat 』ドキュメントの「 GitOps の概要 」を参照してください。
OADP
詳細については、『 Red Hat 』のドキュメントにある 「データ保護のための OpenShift APIの概要 」を参照してください。

次のステップ

すべてのアップグレードを完了したら、環境が正常に動作していること、および災害復旧機能が正しく動作していることを確認してください。 詳細な検証手順については、「 ODF 地域災害復旧構成の検証 」を参照してください。