第6章 更新

手順

1. 次のコマンドを実行し、workloadUpdateMethods 設定を記録します。

   $ oc get kv kubevirt-kubevirt-hyperconverged \
     -n openshift-cnv -o jsonpath='{.spec.workloadUpdateStrategy.workloadUpdateMethods}'

2. 次のコマンドを実行して、すべてのワークロード更新方法をオフにします。

   $ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv \
     --type json -p '[{"op":"replace","path":"/spec/workloadUpdateStrategy/workloadUpdateMethods", "value":[]}]'

   出力例

   hyperconverged.hco.kubevirt.io/kubevirt-hyperconverged patched

3. 続行する前に、HyperConverged Operator が アップグレード可能 であることを確認してください。次のコマンドを入力して、出力をモニターします。

   $ oc get hyperconverged kubevirt-hyperconverged -n openshift-cnv -o json | jq ".status.conditions"

   例6.1 出力例

   [
     {
       "lastTransitionTime": "2022-12-09T16:29:11Z",
       "message": "Reconcile completed successfully",
       "observedGeneration": 3,
       "reason": "ReconcileCompleted",
       "status": "True",
       "type": "ReconcileComplete"
     },
     {
       "lastTransitionTime": "2022-12-09T20:30:10Z",
       "message": "Reconcile completed successfully",
       "observedGeneration": 3,
       "reason": "ReconcileCompleted",
       "status": "True",
       "type": "Available"
     },
     {
       "lastTransitionTime": "2022-12-09T20:30:10Z",
       "message": "Reconcile completed successfully",
       "observedGeneration": 3,
       "reason": "ReconcileCompleted",
       "status": "False",
       "type": "Progressing"
     },
     {
       "lastTransitionTime": "2022-12-09T16:39:11Z",
       "message": "Reconcile completed successfully",
       "observedGeneration": 3,
       "reason": "ReconcileCompleted",
       "status": "False",
       "type": "Degraded"
     },
     {
       "lastTransitionTime": "2022-12-09T20:30:10Z",
       "message": "Reconcile completed successfully",
       "observedGeneration": 3,
       "reason": "ReconcileCompleted",
       "status": "True",
       "type": "Upgradeable" 1
     }
   ]

   1

   OpenShift Virtualization Operator のステータスは Upgradeable です。

4. クラスターをソース EUS バージョンから OpenShift Container Platform の次のマイナーバージョンに手動で更新します。

   $ oc adm upgrade

   検証

   • 次のコマンドを実行して、現在のバージョンを確認します。

     $ oc get clusterversion

     注記

     OpenShift Container Platform を次のバージョンに更新することは、OpenShift Virtualization を更新するための前提条件です。詳細は、OpenShift Container Platform ドキュメントの「クラスターの更新」セクションを参照してください。

5. OpenShift Virtualization を更新します。

   • デフォルトの 自動 承認ストラテジーでは、OpenShift Container Platform を更新した後、OpenShift Virtualization は対応するバージョンに自動的に更新します。
   • 手動 承認ストラテジーを使用する場合は、Web コンソールを使用して保留中の更新を承認します。

6. 次のコマンドを実行して、OpenShift Virtualization の更新をモニターします。

   $ oc get csv -n openshift-cnv

7. OpenShift Virtualization を非 EUS マイナーバージョンで使用可能なすべての z-stream バージョンに更新し、前の手順で示したコマンドを実行して各更新を監視します。

8. 以下のコマンドを実行して、OpenShift Virtualization が非 EUS バージョンの最新の z-stream リリースに正常に更新されたことを確認します。

   $ oc get hyperconverged kubevirt-hyperconverged -n openshift-cnv -o json | jq ".status.versions"

   出力例

   [
     {
       "name": "operator",
       "version": "4.16.4"
     }
   ]

9. 次の更新を実行する前に、HyperConverged Operator が Upgradeable ステータスになるまで待ちます。次のコマンドを入力して、出力をモニターします。

   $ oc get hyperconverged kubevirt-hyperconverged -n openshift-cnv -o json | jq ".status.conditions"

10. OpenShift Container Platform をターゲットの EUS バージョンに更新します。

11. クラスターのバージョンを確認して、更新が成功したことを確認します。

    $ oc get clusterversion

12. OpenShift Virtualization をターゲットの EUS バージョンに更新します。

    • デフォルトの 自動 承認ストラテジーでは、OpenShift Container Platform を更新した後、OpenShift Virtualization は対応するバージョンに自動的に更新します。
    • 手動 承認ストラテジーを使用する場合は、Web コンソールを使用して保留中の更新を承認します。

13. 次のコマンドを実行して、OpenShift Virtualization の更新をモニターします。

    $ oc get csv -n openshift-cnv

    VERSION フィールドがターゲットの EUS バージョンと一致し、PHASE フィールドが Succeeded になると、更新が完了します。

14. 次のコマンドを使用して、ステップ 1 で記録した workloadUpdateMethods 設定を復元します。

    $ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv --type json -p \
      "[{\"op\":\"add\",\"path\":\"/spec/workloadUpdateStrategy/workloadUpdateMethods\", \"value\":{WorkloadUpdateMethodConfig}}]"

    出力例

    hyperconverged.hco.kubevirt.io/kubevirt-hyperconverged patched

    検証

    • 次のコマンドを実行して、VM 移行のステータスを確認します。

      $ oc get vmim -A

手順

1. デフォルトエディターで HyperConverged CR を作成するには、以下のコマンドを実行します。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. HyperConverged CR の workloadUpdateStrategy スタンザを編集します。以下に例を示します。

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     workloadUpdateStrategy:
       workloadUpdateMethods: 1
       - LiveMigrate 2
       - Evict 3
       batchEvictionSize: 10 4
       batchEvictionInterval: "1m0s" 5
   # ...

   1

   ワークロードの自動更新を実行するのに使用できるメソッド。設定可能な値は LiveMigrate および Evict です。上記の例のように両方のオプションを有効にした場合に、ライブマイグレーションをサポートする VMI には LiveMigrate を、ライブマイグレーションをサポートしない VMI には Evict を、更新に使用します。ワークロードの自動更新を無効にするには、workloadUpdateStrategyスタンザを削除するか、workloadUpdateMethods: [] を設定して配列を空のままにします。

   2

   中断を最小限に抑えた更新メソッド。ライブマイグレーションをサポートする VMI は、仮想マシン (VM) ゲストを更新されたコンポーネントが有効なっている新規 Pod に移行することで更新されます。LiveMigrate がリストされている唯一のワークロード更新メソッドである場合には、ライブマイグレーションをサポートしない VMI は中断または更新されません。

   3

   アップグレード時に VMI Pod をシャットダウンする破壊的な方法。Evict は、ライブマイグレーションがクラスターで有効でない場合に利用可能な唯一の更新方法です。VMI が runStrategy: Always に設定された VirtualMachine オブジェクトによって制御される場合には、新規の VMI は、更新されたコンポーネントを使用して新規 Pod に作成されます。

   4

   Evictメソッドを使用して一度に強制的に更新できる VMI の数。これは、LiveMigrate メソッドには適用されません。

   5

   次のワークロードバッチをエビクトするまで待機する間隔。これは、LiveMigrate メソッドには適用されません。

   注記

   HyperConverged CR のspec.liveMigrationConfigスタンザを編集することにより、ライブマイグレーションの制限とタイムアウトを設定できます。

3. 変更を適用するには、エディターを保存し、終了します。