流程

1. 从 Administrator 视角中，点 Operators → OperatorHub。
2. 在 Filter by keyword 字段中输入 OpenShift Virtualization。
3. 选择 OpenShift Virtualization 标题。
4. 阅读 Operator 信息并单击 Install。

5. 在 Install Operator 页面中：

   1. 从可用 Update Channel 选项列表中选择 stable。这样可确保安装与 OpenShift Container Platform 版本兼容的 OpenShift Virtualization 版本。

   2. 对于安装的命名空间，请确保选择了 Operator 推荐的命名空间选项。这会在 openshift-cnv 命名空间中安装 Operator，该命名空间在不存在时自动创建。

      警告

      尝试在 openshift-cnv 以外的命名空间中安装 OpenShift Virtualization Operator 会导致安装失败。

   3. 对于 Approval Strategy，强烈建议您选择 Automatic （默认值），以便在 stable 更新频道中提供新版本时 OpenShift Virtualization 会自动更新。

      虽然可以选择 Manual 批准策略，但这不可取，因为它会给集群提供支持和功能带来高风险。只有在您完全了解这些风险且无法使用 Automatic 时，才选择 Manual。

      警告

      因为 OpenShift Virtualization 只在与对应的 OpenShift Container Platform 版本搭配使用时被支持，所以缺少的 OpenShift Virtualization 更新可能会导致您的集群不被支持。

6. 点击 Install 使 Operator 可供 openshift-cnv 命名空间使用。
7. 当 Operator 成功安装时，点 Create HyperConverged。
8. 可选： 为 OpenShift Virtualization 组件配置 Infra 和 Workloads 节点放置选项。
9. 点击 Create 启动 OpenShift Virtualization。

流程

1. 创建一个包含以下清单的 YAML 文件：

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-cnv
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: kubevirt-hyperconverged-group
     namespace: openshift-cnv
   spec:
     targetNamespaces:
       - openshift-cnv
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: hco-operatorhub
     namespace: openshift-cnv
   spec:
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     name: kubevirt-hyperconverged
     startingCSV: kubevirt-hyperconverged-operator.v4.12.1
     channel: "stable" 1

   1

   使用 stable 频道可确保您安装与 OpenShift Container Platform 版本兼容的 OpenShift Virtualization 版本。

2. 运行以下命令,为 OpenShift Virtualization 创建所需的 Namespace、OperatorGroup 和 Subscription对象：

   $ oc apply -f <file name>.yaml

流程

1. 创建一个包含以下清单的 YAML 文件：

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:

2. 运行以下命令来部署 OpenShift Virtualization Operator:

   $ oc apply -f <file_name>.yaml

流程

1. 在 OpenShift Container Platform web 控制台中进入到 Virtualization > Overview。
2. 点页面右上角的 Download virtctl 链接，并为您的操作系统下载 virtctl 客户端。

3. 安装 virtctl ：

   • Linux：

     1. 解压缩存档文件：

        $ tar -xvf <virtctl-version-distribution.arch>.tar.gz

     2. 运行以下命令使 virtctl 二进制可执行文件：

        $ chmod +x <path/virtctl-file-name>

     3. 将 virtctl 二进制文件移到 PATH 环境变量中的目录中。

        您可以运行以下命令来检查您的路径：

        $ echo $PATH

     4. 设置 KUBECONFIG 环境变量：

        $ export KUBECONFIG=/home/<user>/clusters/current/auth/kubeconfig

   • 对于 Windows:

     1. 解压缩存档文件。
     2. 进入解压的目录中，双击 virtctl 可执行文件来安装客户端。

     3. 将 virtctl 二进制文件移到 PATH 环境变量中的目录中。

        您可以运行以下命令来检查您的路径：

        C:\> path

   • macOS：

     1. 解压缩存档文件。

     2. 将 virtctl 二进制文件移到 PATH 环境变量中的目录中。

        您可以运行以下命令来检查您的路径：

        echo $PATH

1. 删除 HyperConverged CR。
2. 删除 OpenShift Virtualization Operator。
3. 删除 openshift-cnv 命名空间。
4. 删除 OpenShift Virtualization 自定义资源定义 (CRD)。

流程

1. 删除 HyperConverged 自定义资源：

   $ oc delete HyperConverged kubevirt-hyperconverged -n openshift-cnv

2. 删除 OpenShift Virtualization Operator 订阅：

   $ oc delete subscription kubevirt-hyperconverged -n openshift-cnv

3. 删除 OpenShift Virtualization ClusterServiceVersion 资源：

   $ oc delete csv -n openshift-cnv -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

4. 使用 dry-run 选项运行 oc delete crd 命令列出 OpenShift Virtualization 自定义资源定义 (CRD)：

   $ oc delete crd --dry-run=client -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

   输出示例

   customresourcedefinition.apiextensions.k8s.io "cdis.cdi.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hostpathprovisioners.hostpathprovisioner.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hyperconvergeds.hco.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "kubevirts.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "networkaddonsconfigs.networkaddonsoperator.network.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "ssps.ssp.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "tektontasks.tektontasks.kubevirt.io" deleted (dry run)

5. 运行 oc delete crd 命令来删除 CRD，而无需 dry-run 选项：

   $ oc delete crd -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

流程

1. 在 OpenShift Container Platform Web 控制台的 Administrator 视角中，进入 Operators → Installed Operators。
2. 处于待定更新的 Operator 会显示 Upgrade available 状态。点您要更新的 Operator 的名称。
3. 点 Subscription 标签页。任何需要批准的更新都会在 Upgrade Status 旁边显示。例如：它可能会显示 1 requires approval。
4. 点 1 requires approval，然后点 Preview Install Plan。
5. 检查列出可用于更新的资源。在满意后，点 Approve。
6. 返回到 Operators → Installed Operators 页面，以监控更新的进度。完成后，状态会变为 Succeeded 和 Up to date。

流程

1. 运行以下命令：

   $ oc get csv -n openshift-cnv

2. 查看输出，检查 PHASE 字段。例如：

   输出示例

   VERSION  REPLACES                                        PHASE
   4.9.0    kubevirt-hyperconverged-operator.v4.8.2         Installing
   4.9.0    kubevirt-hyperconverged-operator.v4.9.0         Replacing

3. 可选：运行以下命令来监控所有 OpenShift Virtualization 组件状况的聚合状态：

   $ oc get hco -n openshift-cnv kubevirt-hyperconverged \
   -o=jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.message}{"\n"}{end}'

   成功升级后会输出以下内容：

   输出示例

   ReconcileComplete  True  Reconcile completed successfully
   Available          True  Reconcile completed successfully
   Progressing        False Reconcile completed successfully
   Degraded           False Reconcile completed successfully
   Upgradeable        True  Reconcile completed successfully

流程

1. 在 web 控制台中，从 Help 菜单中选择 Quick Starts。
2. 点 Quick Starts 目录里的一个标题。例如：Creating a Red Hat Linux Enterprise Linux virtual machine。
3. 按照教程中的说明，完成导入操作系统镜像并创建虚拟机的任务。Virtualization → VirtualMachines 页面显示虚拟机。

流程

1. 在侧边菜单中点 Virtualization → Catalog。

2. 点 Boot source available 来使用引导源过滤模板。

   注意

   默认情况下，模板列表将仅显示默认模板。过滤时点 All Items，以查看您选择的过滤器的所有可用模板。

3. 点模板查看其详情。

4. 点 Quick Create VirtualMachine 从模板创建虚拟机。

   虚拟机 Details 页面会显示 provisioning 状态。

验证

1. 点 Events 在虚拟机被置备时查看事件流。
2. 点 Console 以验证虚拟机是否已成功引导。

流程

1. 在 web 控制台中选择一个模板：

   1. 在侧边菜单中点 Virtualization → Catalog。
   2. 可选：按项目、关键字、操作系统或工作负载配置集过滤模板。
   3. 点您要自定义的模板。
2. 点 Customize VirtualMachine。
3. 指定虚拟机的参数，包括其 Name 和 Disk source。您可选择指定要克隆的数据源。

验证

1. 点 Events 在虚拟机被置备时查看事件流。
2. 点 Console 以验证虚拟机是否已成功引导。

流程

1. 编辑虚拟机的 VirtualMachine 清单。例如，以下清单配置 Red Hat Enterprise Linux(RHEL)虚拟机：

   例 10.1. RHEL 虚拟机的清单示例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     labels:
       app: <vm_name> 1
     name: <vm_name>
   spec:
     dataVolumeTemplates:
     - apiVersion: cdi.kubevirt.io/v1beta1
       kind: DataVolume
       metadata:
         name: <vm_name>
       spec:
         sourceRef:
           kind: DataSource
           name: rhel9
           namespace: openshift-virtualization-os-images
         storage:
           resources:
             requests:
               storage: 30Gi
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/domain: <vm_name>
       spec:
         domain:
           cpu:
             cores: 1
             sockets: 2
             threads: 1
           devices:
             disks:
             - disk:
                 bus: virtio
               name: rootdisk
             - disk:
                 bus: virtio
               name: cloudinitdisk
             interfaces:
             - masquerade: {}
               name: default
             rng: {}
           features:
             smm:
               enabled: true
           firmware:
             bootloader:
               efi: {}
           resources:
             requests:
               memory: 8Gi
         evictionStrategy: LiveMigrate
         networks:
         - name: default
           pod: {}
         volumes:
         - dataVolume:
             name: <vm_name>
           name: rootdisk
         - cloudInitNoCloud:
             userData: |-
               #cloud-config
               user: cloud-user
               password: '<password>' 2
               chpasswd: { expire: False }
           name: cloudinitdisk

   1

   指定虚拟机的名称。

   2

   指定 cloud-user 的密码。

2. 使用清单文件创建虚拟机：

   $ oc create -f <vm_manifest_file>.yaml

3. 可选：启动虚拟机：

   $ virtctl start <vm_name>

流程

1. 在 web 控制台中进入到 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点具有铅笔图标的字段，这表示该字段可编辑。例如，点当前的 引导模式 设置（如 BIOS 或 UEFI）打开 引导模式 窗口并从列表中选择一个选项。
4. 点击 Save。

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机。
3. 点击 YAML 选项卡以显示可编辑的配置。
4. （可选）：您可点击 Download，在本地下载当前状态的 YAML 文件。
5. 编辑该文件并点击 Save。

流程

1. 运行以下命令以更新虚拟机配置：

   $ oc edit <object_type> <object_ID>

2. 打开对象配置。
3. 编辑 YAML。

4. 如果要编辑正在运行的虚拟机，您需要执行以下任一操作：

   • 重启虚拟机。

   • 运行以下命令使新配置生效：

     $ oc apply <object_type> <object_ID>

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine Details 屏幕。
3. 点 Disks 选项卡，然后点 Add disk。

4. 在 Add disk 窗口中，指定 Source、Name、Size、Type、Interface 和 Storage Class。

   1. 可选：如果您使用空磁盘源并在创建数据卷时要求最大写入性能，则可以启用预分配。如果要这样做，可选中启用预分配复选框。
   2. 可选：您可以清除 Apply optimized StorageProfile 设置，以更改虚拟磁盘的卷模式和访问模式。如果没有指定这些参数，系统将使用 kubevirt-storage-class-defaults 配置映射中的默认值。
5. 点 Add。

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine Details 屏幕。
3. 点击 Network Interfaces 选项卡。
4. 点击 Add Network Interface。
5. 在 Add Network Interface 窗口中，指定网络接口的 Name、Model、Network、Type 和 MAC Address。
6. 点 Add。

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点 Details 标签页。
4. 点击位于 Boot Order 右侧的铅笔图标。如果 YAML 配置不存在，或者是首次创建引导顺序列表时，会显示以下消息: No resource selected.虚拟机会根据在 YAML 文件中的顺序从磁盘引导。
5. 点 Add Source，为虚拟机选择一个可引导磁盘或网络接口控制器 (NIC)。
6. 在引导顺序列表中添加附加磁盘或者 NIC。
7. 点 Save。

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点 Details 标签页。
4. 点击位于 Boot Order 右侧的铅笔图标。

5. 选择适当的方法来移动引导顺序列表中的项目：

   • 如果您没有使用屏幕阅读器，请在您想要移动的项目旁的箭头图标上切换，拖动或下移项目，然后将其放到您选择的位置。
   • 如果您使用屏幕阅读器，请按上箭头或者下箭头键移动引导顺序列表中的项目。然后，按 Tab 键将项目放到您选择的位置。
6. 点 Save。

流程

1. 运行以下命令为虚拟机打开 YAML 配置文件：

   $ oc edit vm example

2. 编辑 YAML 文件并修改与磁盘或网络接口控制器 (NIC) 关联的引导顺序值。例如：

   disks:
     - bootOrder: 1 1
       disk:
         bus: virtio
       name: containerdisk
     - disk:
         bus: virtio
       name: cloudinitdisk
     - cdrom:
         bus: virtio
       name: cd-drive-1
   interfaces:
     - boot Order: 2 2
       macAddress: '02:96:c4:00:00'
       masquerade: {}
       name: default

   1

   为磁盘指定的引导顺序值。

   2

   为网络接口控制器指定的引导顺序值。

3. 保存 YAML 文件。
4. 点 reload the content，使 YAML 文件中更新的引导顺序值应用到 web 控制台的引导顺序列表中。

流程

1. 在侧边菜单中点 Virtualization → VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点 Details 标签页。
4. 点击位于 Boot Order 右侧的铅笔图标。
5. 点击项 旁边的 Remove 图标。该项目从引导顺序列表中删除，可用引导源列表的内容被保存。如果您从引导顺序列表中删除所有项目，则会显示以下消息: No resource selected.虚拟机会根据在 YAML 文件中的顺序从磁盘引导。

流程

1. 在 OpenShift Container Platform 控制台中，从侧边菜单中点 Virtualization → VirtualMachines。

2. 点您要删除的虚拟机的 Options 菜单 ，然后选择 Delete。

   • 或者，击虚拟机名称，打开 VirtualMachine 详情页面并点击 Actions → Delete。
3. 在确认弹出窗口中，点击 Delete 永久删除虚拟机。

流程

1. 创建一个 VirtualMachineExport 清单，根据以下示例从 VirtualMachine、VirtualMachineSnapshot 或 PersistentVolumeClaim CR 导出卷，并将其保存为 example-export.yaml ：

   VirtualMachineExport 示例

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
   spec:
     source:
       apiGroup: "kubevirt.io" 1
       kind: VirtualMachine 2
       name: example-vm
     ttlDuration: 1h 3

   1

   指定适当的 API 组：

   • "kubevirt.io" 用于 VirtualMachine。
   • "snapshot.kubevirt.io" 用于 VirtualMachineSnapshot。
   • "" 用于 PersistentVolumeClaim。

   2

   指定 VirtualMachine, VirtualMachineSnapshot, 或 PersistentVolumeClaim。

   3

   可选。默认持续时间为 2 小时。

2. 创建 VirtualMachineExport CR：

   $ oc create -f example-export.yaml

3. 获取 VirtualMachineExport CR：

   $ oc get vmexport example-export -o yaml

   导出的卷的内部和外部链接显示在 status 小节中：

   输出示例

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
     namespace: example
   spec:
     source:
       apiGroup: ""
       kind: PersistentVolumeClaim
       name: example-pvc
     tokenSecretRef: example-token
   status:
     conditions:
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:10:09Z"
       reason: podReady
       status: "True"
       type: Ready
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:09:02Z"
       reason: pvcBound
       status: "True"
       type: PVCReady
     links:
       external: 1
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img
           - format: gzip
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img.gz
           name: example-disk
       internal:  2
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img
           - format: gzip
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img.gz
           name: example-disk
     phase: Ready
     serviceName: virt-export-example-export

   1

   可以使用 Ingress 或 Route 从集群外部访问外部链接。

   2

   内部链接只在集群内有效。