KVM 虚拟机 virsh 命令备忘单

快来打我* 2023-10-01 11:07 15阅读 0赞

这是一个全面的 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>**部分并修改以下行的值：

例子

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 的可用快照，请使用：

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 虚拟磁盘][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 网络][Linux _ virsh_nmcli _ brctl _ KVM]

### 结论 ###

我们的 virsh 命令备忘单现已完成。

[KVM _ VM]: https://computingforgeeks.com/how-to-mount-vm-virtual-disk-on-kvm-hypervisor/
[Linux _ virsh_nmcli _ brctl _ KVM]: https://computingforgeeks.com/managing-kvm-network-interfaces-in-linux/