这是一个全面的 virsh 命令备忘单: virsh 是 KVM 虚拟机的命令管理用户界面。virsh 可用于创建、暂停、重新启动和关闭域。此外,virsh 可用于列出您的虚拟化管理程序平台中可用的当前域。
virsh 与 Libvirt 交互,后者是一个旨在提供长期稳定的 C API 的库。目前支持 Xen、QEMU、KVM、LXC、OpenVZ、VirtualBox 和 VMware ESX。
Virsh 命令备忘单
在这个 virsh 命令备忘单中,我将向您展示最常用的 virsh 命令来管理在 KVM 或 Xen Hypervisor 上运行的来宾虚拟机。
大多数virsh用法的基本结构是:
$ virsh [OPTION]... <command> <domain> [ARG]...
Virsh 显示节点信息:
这是我们的 virsh 命令备忘单上的第一项。这将显示主机节点信息和支持虚拟化过程的机器。
# virsh nodeinfo
CPU 型号: x86_64
CPU: 2
CPU 频率: 2790 MHz
CPU socket: 2
每个 socket 的内核数: 1
每个内核的线程数: 1
NUMA 单元: 1
内存大小: 3826180 KiB
列出操作系统变体
要获取--os-variant
运行以下命令的值:
$ osinfo-query os
Virsh 列出所有域
要列出非活动域和活动域,请使用以下命令:
# virsh list --all
Id 名称 状态
-----------------------------
- CentOS-Stream 关闭
- centos-stream8 关闭
仅列出活动域
要使用virsh
命令仅列出活动域 ,请使用:
# virsh list
Id 名称 状态
-------------------
Virsh 重命名域
句法:
virsh domrename currentname newname
列出可用域
# virsh list --all
Id 名称 状态
-----------------------------
- CentOS-Stream 关闭
- centos-stream8 关闭
# virsh domrename CentOS-Stream CentOS-Stream-New
Domain successfully renamed
# virsh list --all
Id 名称 状态
--------------------------------
- CentOS-Stream-New 关闭
- centos-stream8 关闭
我们已经将域的名称从CentOS-Stream更改为CentOS-Stream-New
Virsh 更改域启动盘
通过传递名称来编辑域:
virsh edit domain
向下滚动直到<devices>部分并修改以下行的值:
<source file=''/>
例子
<source file='/var/lib/libvirt/images/apacheserver01.qcow2'/>
Virsh 启动虚拟机
这是一个关于如何使用 virsh 命令启动来宾虚拟机的示例。我们将启动 test
上面显示的域:
$ sudo virsh start test
Domain test started
$ sudo virsh list
Id Name State
----------------------------------------------------
3 test running
Virsh 自动启动虚拟机
要将 vm 设置为在系统启动时自动启动,请执行以下操作:
$ sudo virsh autostart test
Domain test marked as autostarted
$ sudo virsh dominfo test
Id: 9
Name: test
UUID: a943ed42-ba62-4270-a41d-7f81e793d754
OS Type: hvm
State: running
CPU(s): 2
CPU time: 144.6s
Max memory: 2048 KiB
Used memory: 2048 KiB
Persistent: yes
Autostart: enable
Managed save: no
Security model: none
Security DOI: 0
密切关注该选项 Autostart: enable
。
Virsh 自动启动禁用
要禁用虚拟机的自动启动功能:
$ virsh autostart --disable test
Domain test unmarked as autostarted
$ virsh dominfo test
Id: -
Name: test
UUID: a943ed42-ba62-4270-a41d-7f81e793d754
OS Type: hvm
State: shut off
CPU(s): 2
Max memory: 2048 KiB
Used memory: 2048 KiB
Persistent: yes
Autostart: disable
Managed save: no
Security model: none
Security DOI: 0
virsh 停止虚拟机,virsh 关闭虚拟机
要优雅地关闭正在运行的虚拟机,请使用:
$ sudo virsh shutdown test
Domain test is being shutdown
$ sudo virsh list
Id Name State
----------------------------------------------------
Virsh 强制关闭虚拟机
您可以使用以下命令强制关闭活动域:
$ sudo virsh destroy test
Virsh 停止所有正在运行的虚拟机
如果您想关闭所有正在运行的域,只需发出以下命令:
$ for i in `sudo virsh list | grep running | awk '{print $2}'` do
sudo virsh shutdown $i
done
Virsh 重启虚拟机
要重新启动名为 的虚拟机 test
,使用的命令是:
sudo virsh reboot test
Virsh 删除虚拟机
要彻底删除 vm 及其存储列,请使用如下所示的命令。该域 test
应替换为要删除的实际域。
sudo virsh destroy test 2> /dev/null
sudo virsh undefine test
sudo virsh pool-refresh default
sudo virsh vol-delete --pool default test.qcow2
在这个例子中,存储卷被命名为 /var/lib/libvirt/images/test.qcow2
您还可以将 undefine 与–remove-all-storage选项一起使用:
virsh undefine test --remove-all-storage
Virsh 创建一个虚拟机
如果你想用 virsh 创建一个新的虚拟机,要使用的相关命令是virt-install
. 这是至关重要的,不能错过 virsh 命令备忘单库。下面的示例将从 CentOS 7 ISO 映像安装一个新的操作系统。
sudo virt-install \
--name centos7 \
--description "Test VM with CentOS 7" \
--ram=1024 \
--vcpus=2 \
--os-type=Linux \
--os-variant=rhel7 \
--disk path=/var/lib/libvirt/images/centos7.qcow2,bus=virtio,size=10 \
--graphics none \
--location $HOME/iso/CentOS-7-x86_64-Everything-1611.iso \
--network bridge:virbr0 \
--console pty,target_type=serial -x 'console=ttyS0,115200n8 serial'
Virsh 连接到虚拟机控制台
要连接到访客控制台,请使用以下命令:
$ sudo virsh console test
如果提供的域存在活动控制台会话,这将返回失败消息。要解决此运行:
$ sudo virsh console test --force
Virsh 编辑 vm xml 文件
要编辑 vm xml 文件,请使用:
$ sudo EDITOR=vim
$ virsh edit test
使用 nano 文本编辑器
$ sudo EDITOR=nano
$ virsh edit test
Virsh 挂起虚拟机,virsh 恢复虚拟机
要挂起名为 testwith virsh 命令的来宾,请运行:
$ sudo virsh suspend test
Domain test suspended
注意:当域处于挂起状态时,它仍会消耗系统 RAM。来宾挂起时不会发生磁盘和网络 I/O。
恢复访客虚拟机:
使用 resume 选项使用 virsh 恢复挂起的客户机:
$ sudo virsh resume test
Domain test resumed
Virsh 保存虚拟机
使用 virsh 命令将虚拟机的当前状态保存到文件中:
语法是:
$ sudo virsh save test test.saved
Domain test saved to test.save
$ ls -l test.save
-rw------- 1 root root 328645215 Mar 18 01:35 test.saved
恢复保存的虚拟机
从文件中恢复保存的虚拟机:
$ sudo virsh restore test.save
Domain restored from test.save
$ sudo virsh list
Id Name State
----------------------------------------------------
7 test running
Virsh 管理卷
在这里,我们将介绍如何创建存储卷、将其附加到 vm、将其从 vm 分离以及如何删除卷。
Virsh 创建卷
要在默认存储池上创建一个名为 test_vol2 的 2GB 卷,请使用:
$ sudo virsh vol-create-as default test_vol2.qcow2 2G
Vol test_vol2.qcow2 created
$ sudo du -sh /var/lib/libvirt/images/test_vol2.qcow2
2.0G/var/lib/libvirt/images/test_vol2.qcow2
- 默认值:是池名称。
- test_vol2:这是卷的名称。
- 2G:这是卷的存储容量。
列出卷
sudo virsh vol-list --pool default
sudo virsh vol-list --pool images
Virsh 将卷附加到 vm
要将上面创建的卷附加到 vm 测试,请运行:
$ sudo virsh attach-disk --domain test \
--source /var/lib/libvirt/images/test_vol2.qcow2 \
--persistent --target vdb
-
--persistent
:使实时更改持久化 -
--target vdb
: 磁盘设备的目标
您可以确认该卷已作为块设备添加到 vm /dev/vdb
$ ssh test
Last login: Fri Mar 17 19:30:54 2017 from gateway
[root@test ~]#
[root@test ~]# lsblk --output NAME,SIZE,TYPE
NAME SIZE TYPE
sr0 1024M rom
vda 10G disk
├─vda1 1G part
└─vda2 9G part
├─cl_test-root 8G lvm
└─cl_test-swap 1G lvm
vdb 2G disk
显示如何创建和附加辅助虚拟磁盘的示例:
export VM=test-vm
sudo qemu-img create -f qcow2 /var/lib/libvirt/images/${VM}-disk2.qcow2 20g
sudo virsh attach-disk \
--source /var/lib/libvirt/images/${VM}-disk2.qcow2 \
--target vdb \
--persistent \
--subdriver qcow2 \
--driver qemu \
--type disk
虚拟机上的 Virsh 分离卷
要将上面的卷 test_vol2 从 vm 测试中分离出来:
$ sudo virsh detach-disk --domain test --persistent --live --target vdb
Disk detached successfully
$ ssh test
Last login: Sat Mar 18 01:52:33 2017 from gateway
[root@test ~]#
[root@test ~]# lsblk --output NAME,SIZE,TYPE
NAME SIZE TYPE
sr0 1024M rom
vda 10G disk
├─vda1 1G part
└─vda2 9G part
├─cl_test-root 8G lvm
└─cl_test-swap 1G lvm
[root@test ~]#
您确实可以从此输出确认设备 /dev/vdb 已分离
请注意,您可以使用 qemu-img 命令直接为 vm 增加磁盘映像,这将如下所示:
$ sudo qemu-img resize /var/lib/libvirt/images/test.qcow2 +1G
上述命令的主要缺点是您无法调整具有快照的图像的大小。
Virsh 删除卷
列出存储池:
$ sudo virsh pool-list
Name State Autostart
------------------------------
default active yes
要使用 virsh 命令删除卷,请使用:
# List volumes
$ sudo virsh vol-list --pool default
$ sudo virsh vol-delete test_vol2.qcow2 --pool default
Vol test_vol2.qcow2 deleted
$ sudo virsh pool-refresh default
Pool default refreshed
$ sudo virsh vol-list default
Name Path
------------------------------------------------------------------------------
admin.qcow2 /var/lib/libvirt/images/admin.qcow2
cloudstack.qcow2 /var/lib/libvirt/images/cloudstack.qcow2
ipa.qcow2 /var/lib/libvirt/images/ipa.qcow2
katello.qcow2 /var/lib/libvirt/images/katello.qcow2
node1.qcow2 /var/lib/libvirt/images/node1.qcow2
node2.qcow2 /var/lib/libvirt/images/node2.qcow2
node3.qcow2 /var/lib/libvirt/images/node3.qcow2
test.qcow2 /var/lib/libvirt/images/test.qcow2
ubuntu14.04.qcow2 /var/lib/libvirt/images/ubuntu14.04.qcow2
zenoss.qcow2 /var/lib/libvirt/images/zenoss.qcow2
Virsh 管理快照
在使用 virsh 命令管理 kvm 来宾机器的最后第二部分中,我们将了解管理 VM 快照。
Virsh 为虚拟机创建快照
让我们为我们的测试虚拟机创建一个快照。
$ sudo virsh snapshot-create-as --domain test \
--name "test_vm_snapshot1" \
--description "test vm snapshot 1-working"
Domain snapshot test_vm_snapshot1 created
虚拟机的 Virsh 列表快照
要列出 vm 的可用快照,请使用:
$ sudo virsh snapshot-list test
Name Creation Time State
------------------------------------------------------------
1489689679 2017-03-16 21:41:19 +0300 shutoff
test_fresh 2017-03-16 22:11:48 +0300 shutoff
test_vm_snapshot1 2017-03-18 02:15:58 +0300 running
Virsh 显示有关快照的信息:
要检索有关域的更多信息,请使用:
$ sudo virsh snapshot-info --domain test --snapshotname test_vm_snapshot1
Name: test_vm_snapshot1
Domain: test
Current: yes
State: running
Location: internal
Parent: test_fresh
Children: 0
Descendants: 0
Metadata: yes
Virsh 还原虚拟机快照
在这里,我们将创建另一个名为 test_vm_snapshot2 的快照,然后还原为快照 test_vm_snapshot1
$ sudo virsh snapshot-create-as \
--domain test --name "test_vm_snapshot2" \
--description "test vm snapshot 2-working"
Domain snapshot test_vm_snapshot2 created
让我们恢复之前创建的快照:
$ sudo virsh snapshot-list test
Name Creation Time State
------------------------------------------------------------
1489689679 2017-03-16 21:41:19 +0300 shutoff
test_fresh 2017-03-16 22:11:48 +0300 shutoff
test_vm_snapshot1 2017-03-18 02:15:58 +0300 running
test_vm_snapshot2 2017-03-18 02:23:29 +0300 running
$ sudo virsh snapshot-revert --domain test --snapshotname test_vm_snapshot1 --running
Virsh 删除快照
让我们删除我们创建的两个快照:
$ sudo virsh snapshot-delete --domain test --snapshotname test_vm_snapshot2
Domain snapshot test_vm_snapshot2 deleted
$ sudo virsh snapshot-delete --domain test --snapshotname test_vm_snapshot1
Domain snapshot test_vm_snapshot1 deleted
$ sudo virsh snapshot-list test
Name Creation Time State
------------------------------------------------------------
1489689679 2017-03-16 21:41:19 +0300 shutoff
test_fresh 2017-03-16 22:11:48 +0300 shutoff
Virsh 克隆一个虚拟机
具有要克隆的设备的域必须暂停或关闭。所以让我们关闭它:
$ sudo virsh destroy test
Domain test destroyed
然后克隆一个虚拟机,如下图所示:
$ sudo virt-clone --connect qemu:///system \
--original test \
--name test_clone \
--file /var/lib/libvirt/images/test_clone.qcow2
Allocating 'test_clone.qcow2' | 10 GB 00:00:06
Clone 'test_clone' created successfully.
$ sudo virsh dominfo test_clone
Id: -
Name: test_clone
UUID: be0621fd-51b5-4d2b-a05c-ce76e59baafa
OS Type: hvm
State: shut off
CPU(s): 1
Max memory: 1048576 KiB
Used memory: 1048576 KiB
Persistent: yes
Autostart: disable
Managed save: no
Security model: none
Security DOI: 0
Virsh 管理虚拟机 vcpus
这个 virsh 命令备忘单部分介绍了如何向虚拟机添加额外的虚拟 CPU:
$ sudo virsh setvcpus --domain test --maximum 2 --config
$ sudo virsh setvcpus --domain test --count 2 --config
$ sudo virsh shutdown test
$ sudo virsh start test
确认vcpu的数量发生了变化,之前是1,现在是2:
$ virsh dominfo test
Id: -
Name: test
UUID: a943ed42-ba62-4270-a41d-7f81e793d754
OS Type: hvm
State: shut off
CPU(s): 2
Max memory: 1048576 KiB
Used memory: 1048576 KiB
Persistent: yes
Autostart: disable
Managed save: no
Security model: none
Security DOI: 0
Virsh 管理虚拟机内存
同样在 virsh 命令备忘单上使用 virsh 管理 RAM。要调整客户机操作系统使用的总内存,使用以下命令:
# In MB
sudo virsh setmaxmem test 2048 --config
sudo virsh setmem test 2048 --config
sudo virsh shutdown test
sudo virsh start test
# Same in GB
sudo virsh setmaxmem test 16G --config
sudo virsh setmem test 16G --config
sudo virsh shutdown test
sudo virsh start test
检查域信息以确认分配给 VM 的当前 RAM。
$ virsh dominfo test
Id: 9
Name: test
UUID: a943ed42-ba62-4270-a41d-7f81e793d754
OS Type: hvm
State: running
CPU(s): 2
CPU time: 70.7s
Max memory: 2048 KiB
Used memory: 2048 KiB
Persistent: yes
Autostart: disable
Managed save: no
Security model: none
Security DOI: 0
注意当前分配给VM的ram是2048
挂载虚拟磁盘
您可以在 KVM 上挂载虚拟磁盘以进行离线管理。为此,我们有一篇现成的文章,您可以从以下链接中参考:
如何在 KVM 管理程序上挂载 VM 虚拟磁盘
ls 虚拟机中的目录
要在正在运行的 VM 上 ls 目录,您需要安装 libguestfs-tools。
运行:
# virt-ls -l -d <domain> <directory>
例如
# virsh list
Id Name State
----------------------------------------------------
10 allot_netxplorer_01 running
19 sg-ve-01 running
# virt-ls -l -d allot_netxplorer_01 /root
total 28
dr-xr-x---. 2 root root 135 Mar 22 14:26 .
dr-xr-xr-x. 17 root root 224 Mar 21 10:37 ..
-rw-------. 1 root root 385 Mar 22 14:26 .bash_history
-rw-r--r--. 1 root root 18 Dec 29 2013 .bash_logout
-rw-r--r--. 1 root root 176 Dec 29 2013 .bash_profile
-rw-r--r--. 1 root root 176 Dec 29 2013 .bashrc
-rw-r--r--. 1 root root 100 Dec 29 2013 .cshrc
-rw-r--r--. 1 root root 129 Dec 29 2013 .tcshrc
-rw-------. 1 root root 1447 Mar 21 10:38 anaconda-ks.cfg
常见的选项有:
-R |--recursive --> Recursive listing
-h |--human-readable --> Human-readable sizes in output
-d |--domain guest --> Add disks from libvirt guest
-l |--long --> Long listing
cat 虚拟机中的文件
您也可以在不对 VM 执行 ssh 或通过控制台访问它的情况下 cat 文件。您需要在管理程序上安装 libguestfs 工具才能使其工作。
$ sudo virt-cat -d <domain> <file_path>
$ sudo virt-cat -d sg-ve-01 /etc/redhat-release
CentOS Linux release 7.1.1503 (Core)
$ sudo dufo virt-cat -d sg-ve-01 /etc/redhat-release > check_os
$ cat check_os
CentOS Linux release 7.1.1503 (Core)
在虚拟机中编辑文件
在管理程序上安装 libguestfs-tools 后,使用 virsh-edit 命令:
# virt-edit -d sg-ve-01 /etc/hosts
显示虚拟机磁盘使用情况
使用 virt-df 命令:
$ sudo virt-df -d sg-ve-01
Filesystem 1K-blocks Used Available Use%sg-ve-01:/dev/sda1 20469760 3954792 16514968 20%
sg-ve-01:/dev/sda2 27739924 173828 27566096 1%
列出
虚拟机或磁盘映像中的文件系统、分区、块设备、LVM
$ sudo virt-filesystems -l -d sg-ve-01
Name Type VFS Label Size Parent
/dev/sda1 filesystem xfs - 20971520000 -
/dev/sda2 filesystem xfs - 28419555328 -
$ sudo virt-filesystems -l -h -d sg-ve-01
Name Type VFS Label Size Parent
/dev/sda1 filesystem xfs - 20G -
/dev/sda2 filesystem xfs - 26G -
$ sudo virt-filesystems -l -h -d sg-ve-01 --partitions
Name Type MBR Size Parent
/dev/sda1 partition 83 20G /dev/sda
/dev/sda2 partition 83 26G /dev/sda
/dev/sda3 partition 82 4.0G /dev/sda
$ sudo virt-filesystems -d sg-ve-01 --all --long --uuid -h
Name Type VFS Label MBR Size Parent UUID
/dev/sda1 filesystem xfs - - 20G - 97074514-612e-4d1c-8433-935dbb3ec775
/dev/sda2 filesystem xfs - - 26G - 8cc9e0cd-282d-46a4-9a37-069dfb93c4f2
/dev/sda3 filesystem swap - - 4.0G - ad7dcd49-fe1a-4938-8600-f7299a59c57a
/dev/sda1 partition - - 83 20G /dev/sda -
/dev/sda2 partition - - 83 26G /dev/sda -
/dev/sda3 partition - - 82 4.0G /dev/sda -
/dev/sda device - - - 100G - -
显示虚拟化域的统计信息
使用 virt-top 显示虚拟化域的统计信息。您可以按 CPU、RAM 等过滤并将输出保存到 CSV 文件。
$ virt-top
$ sudo virt-top --csv file.csv
您还可以将调试和错误消息发送到文件名。要将错误消息发送到 syslog,您可以执行以下操作:
$ sudo virt-top --debug >(logger -t virt-top)
显示来自虚拟机的日志文件
“virt-log”是一个命令行工具,用于显示来自命名虚拟机(或磁盘映像)的日志文件。该工具理解并显示纯文本日志文件(例如 /var/log/messages)和二进制格式,例如 systemd 日志。
$ sudo virt-log -d <domain> | less
$ sudo virt-log -d <domain> | grep 'dhclient.*bound to'
Virsh 管理网络
要结束我们的 virsh 命令备忘单内容,请阅读我之前的文章:
在 Linux 中使用 virsh、nmcli 和 brctl 配置 KVM 网络
结论
我们的 virsh 命令备忘单现已完成。