9.2. virtctl 命令

9.2.1. virtctl 信息命令

您可使用 virtctl 信息命令查看 virtctl 客户端的信息。

表 9.1. 信息命令
命令	描述
`virtctl version`	查看 `virtctl` 客户端和服务器版本。
`virtctl help`	查看 `virtctl` 命令列表。
`virtctl <command> -h\|--help`	查看特定命令的选项列表。
`virtctl 选项`	查看任何 `virtctl` 命令的全局命令选项列表。

9.2.2. VM 信息命令

您可使用 virtctl 查看有关虚拟机和 VMI 的信息。

表 9.2. VM 信息命令
命令	描述
`virtctl fslist <vm_name>`	查看客户机机器上可用的文件系统。
`virtctl guestosinfo <vm_name>`	查看客户机机器上操作系统的信息。
`virtctl userlist <vm_name>`	查看客户机机器上的登录用户。

9.2.3. VM 管理命令

您可使用 virtctl 虚拟机 (VM) 管理命令管理和迁移虚拟机和 VMI。

表 9.3. VM 管理命令
命令	描述
`virtctl create -name <vm_name>`	创建 `VirtualMachine` 清单。
`virtctl start <vm_name>`	启动虚拟机。
`virtctl start --paused <vm_name>`	以暂停状态启动虚拟机。这个选项可让您从 VNC 控制台中断引导过程。
`virtctl stop <vm_name>`	停止虚拟机。
`virtctl stop <vm_name> --grace-period 0 --force`	强制停止虚拟机。这个选项可能会导致数据不一致或数据丢失。
`virtctl pause vm <vm_name>`	暂停虚拟机。机器状态保存在内存中。
`virtctl unpause vm <vm_name>`	取消暂停虚拟机。
`virtctl migrate <vm_name>`	迁移虚拟机。
`virtctl restart <vm_name>`	重启虚拟机。

9.2.4. VM 连接命令

您可使用 virtctl 连接命令来公开端口并连接到虚拟机和 VMI。

表 9.4. VM 连接命令
命令	描述
`virtctl console <vm_name>`	连接到虚拟机的串行控制台。
`virtctl expose <vm_name>`	创建转发虚拟机的指定端口的服务，并在节点的指定端口上公开服务。
`virtctl scp -i <ssh_key> <file_name> <user_name>@<vm_name>`	将文件从机器复制到虚拟机。此命令使用 SSH 密钥对的私钥。虚拟机必须配置有公钥。
`virtctl scp -i <ssh_key> <user_name@<vm_name>:<file_name> .`	将文件从虚拟机复制到您的机器中。此命令使用 SSH 密钥对的私钥。虚拟机必须配置有公钥。
`virtctl ssh -i <ssh_key> <user_name>@<vm_name>`	与虚拟机打开 SSH 连接。此命令使用 SSH 密钥对的私钥。虚拟机必须配置有公钥。
`virtctl vnc --kubeconfig=$KUBECONFIG <vm_name>`	连接到虚拟机的 VNC 控制台。通过 VNC 访问 VMI 的图形控制台需要在本地机器上有一个远程查看器。
`virtctl vnc --kubeconfig=$KUBECONFIG --proxy-only=true <vm_name>`	显示端口号，并使用任何查看器通过 VNC 连接手动连接到 VMI。
`virtctl vnc --kubeconfig=$KUBECONFIG --port=<port-number> <vm_name>`	如果该端口可用，则指定端口号用于在指定端口上运行代理。如果没有指定端口号，代理会在随机端口上运行。

9.2.5. VM 导出命令

您可使用 virtctl vmexport 命令来创建、下载或删除从虚拟机、虚拟机快照或持久性卷声明 (PVC) 导出的卷。

表 9.5. VM 导出命令
命令	描述
`virtctl vmexport create <vmexport_name> --vm\|snapshot\|pvc=<object_name>`	创建一个 `VirtualMachineExport` 自定义资源 (CR) 来从虚拟机、虚拟机快照或 PVC 导出卷。 `--vm`: 导出虚拟机的 PVC。 `--snapshot` ：导出 `VirtualMachineSnapshot` CR 中包含的 PVC。 `--pvc`: 导出 PVC。可选： `--ttl=1h` 指定生存时间。默认持续时间为 2 小时。
`virtctl vmexport delete <vmexport_name>`	手动删除 `VirtualMachineExport` CR。
`virtctl vmexport download <vmexport_name> --output=<output_file> --volume=<volume_name>`	下载在 `VirtualMachineExport` CR 中定义的卷。 `--output` 指定文件格式。示例： `disk.img.gz`. `--volume` 指定要下载的卷。如果只有一个卷可用，则此标志是可选的。可选： `--keep-vme` 在下载后保留 `VirtualMachineExport` CR。默认的行为是在下载后删除 `VirtualMachineExport` CR 的默认行为。 `--insecure` 启用不安全的 HTTP 连接。
`virtctl vmexport download <vmexport_name> --<vm\|snapshot\|pvc>=<object_name> --output=<output_file> --volume=<volume_name>`	创建一个 `VirtualMachineExport` CR，然后下载 CR 中定义的卷。

9.2.6. VM 内存转储命令

您可使用 virtctl memory-dump 命令在 PVC 上输出虚拟机 (VM) 内存转储。您可以指定现有的 PVC，或使用 --create-claim 标志来创建新 PVC。

先决条件

PVC 卷模式必须是 FileSystem。
PVC 必须足够大以保存内存转储。
计算 PVC 大小的公式为 (VMMemorySize + 100Mi)* FileSystemOverhead，其中 100Mi 是内存转储开销。

您必须运行以下命令来在 HyperConverged 自定义资源中启用热插功能：

$ oc patch hco kubevirt-hyperconverged -n openshift-cnv \
  --type json -p '[{"op": "add", "path": "/spec/featureGates", \
  "value": "HotplugVolumes"}]'

下载内存转储

您必须使用 virtctl vmexport download 命令下载内存转储：

$ virtctl vmexport download <vmexport_name> --vm\|pvc=<object_name> \
  --volume=<volume_name> --output=<output_file>

表 9.6. VM 内存转储命令
命令	描述
`virtctl memory-dump get <vm_name> --claim-name=<pvc_name>`	在 PVC 上保存虚拟机的内存转储。内存转储状态显示在 `VirtualMachine` 资源的 `status` 部分。可选： `--create-claim` 会创建一个具有适当大小的新 PVC。这个标志有以下选项： `--storage-class=<storage_class>`: 为 PVC 指定存储类。 `--access-mode=<access_mode>`: 指定 `ReadWriteOnce` 或 `ReadWriteMany`。
`virtctl memory-dump get <vm_name>`	使用相同的 PVC 重新运行 `virtctl memory-dump` 命令。这个命令覆盖以前的内存转储。
`virtctl memory-dump remove <vm_name>`	删除内存转储。如果要更改目标 PVC，则必须手动删除内存转储。这个命令会删除虚拟机和 PVC 之间的关联，以便在 `VirtualMachine` 资源的 `status` 部分中不会显示内存转储。PVC 不受影响。

9.2.7. 热插和热拔命令

您可使用 virtctl 从正在运行的虚拟机和 VMI 中添加或删除资源。

表 9.7. 热插和热拔命令
命令	描述
`virtctl addvolume <vm_name> --volume-name=<datavolume_or_PVC> [--persist] [--serial=<label>]`	热插数据卷或持久性卷声明 (PVC)。可选： `--persist` 在虚拟机上永久挂载虚拟磁盘。这个标志不适用于 VMI。 `--serial=<label>` 为虚拟机添加一个标签。如果没有指定标签，则默认标签是数据卷或 PVC 名称。
`virtctl removevolume <vm_name> --volume-name=<virtual_disk>`	热拔虚拟磁盘。

9.2.8. 镜像上传命令

您可使用 virtctl image-upload 命令将虚拟机镜像上传到数据卷中。

表 9.8. 镜像上传命令
命令	描述
`virtctl image-upload dv <datavolume_name> --image-path=</path/to/image> --no-create`	将虚拟机镜像上传到已存在的数据卷中。
`virtctl image-upload dv <datavolume_name> --size=<datavolume_size> --image-path=</path/to/image>`	将虚拟机镜像上传到指定请求大小的新数据卷中。

9.2.1. virtctl 信息命令

9.2.2. VM 信息命令

9.2.3. VM 管理命令

9.2.4. VM 连接命令

9.2.5. VM 导出命令

9.2.6. VM 内存转储命令

9.2.7. 热插和热拔命令

9.2.8. 镜像上传命令

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links