第 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 为 Upgradeable。输入以下命令并监控输出：

   $ 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。

   • 使用默认的 Automatic 批准策略，OpenShift Virtualization 会在更新 OpenShift Container Platform 后自动更新到对应的版本。
   • 如果使用 Manual 批准策略，请使用 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.15.6"
     }
   ]

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 版本。

    • 使用默认的 Automatic 批准策略，OpenShift Virtualization 会在更新 OpenShift Container Platform 后自动更新到对应的版本。
    • 如果使用 Manual 批准策略，请使用 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

    验证

    • 运行以下命令检查虚拟机迁移的状态：

      $ 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 对象控制，则会在带有更新组件的新 pod 中创建一个新的 VMI。

   4

   使用 Evict 方法每次可以强制更新的 VMI 数量。这不适用于 LiveMigrate 方法。

   5

   驱除下一批工作负载前等待的时间间隔。这不适用于 LiveMigrate 方法。

   注意

   您可以通过编辑 HyperConverged CR 的 spec.liveMigrationConfig 小节来配置实时迁移限制和超时。

3. 若要应用您的更改，请保存并退出编辑器。