一、简介
libvirt是Linux上的虚拟化库,是长期稳定的C语言API,支持KVM/QEMU、Xen、LXC等主流虚拟化方案。链接:
API开发手册:
virsh是libvirt对应的shell命令。
之前写了一篇使用virsh管理kvm虚拟机的博客《使用libvirt管理kvm(virsh篇)》(传送门:),这里再从编程接口API的角度介绍如何使用libvirt管理kvm虚拟机。
二、环境介绍
OS:Ubuntu 12.04.1 LTS
内核:Linux 3.2.0-33-generic-pae #52-Ubuntu SMP Thu Oct 18 16:39:21 UTC 2012 i686 i686 i386 GNU/Linux
libvirt:0.9.8
三、准备工作
ubuntu安装,直接apt-get install
1、安装kvm/qemu
sudo apt-get install kvm qemu
2、安装libvirt
sudo apt-get install libvirt-bin libvirt-dev
3、网桥管理工具
sudo apt-get install bridge-utils
4、统一建模语言
sudo apt-get install uml-utilities
5、vnc 虚拟机查看工具
sudo apt-get install vncviewer vnc4server
四、创建镜像
在指定目录下
执行 qemu-img create -f raw template.img 3G
这样就创建了一个大小为3G的镜像(img)
有人可能问镜像是什么东西。简单的说,我们在镜像上启动一个虚拟机,这个3G的镜像就相当于这个虚拟机对应的磁盘空间。
也有人执行 qemu-img create -f qcow2 template.img 3G,(备注:qcow2支持动态扩张)来获得一个动态扩张的镜像。我个人还需要对磁盘资源进行简单的统计、管理,因此没有用这个。不同情景下可能这种模式更好,有兴趣的朋友自己试一下。
五、libvirt xml配置文件
libvirt(包括virsh)使用xml文件对虚拟机进行配置,其中包括虚拟机名称、分配内存、vcpu等多种信息。定义、创建虚拟机等操作都需要xml配置文件的参与,因此这里先介绍xml配置文件。我编辑了一个名为template.xml的xml文件,其中定义了一个名为demo的kvm 虚拟机。
//虚拟机类型,kvm demo //虚拟机名称1048576 //分配内存,单位kb1 //分配vcpu,单位个数hvm //cd 启动 //硬盘启动 destroy restart destroy /usr/bin/kvm //对应的镜像,就是之前使用qemu-img命令新建的img文件,注意路径要正确 //可选项,iso通常是操作系统的安装光盘 //libvirt默认虚拟机的网络配置是NAT模式,就是虚拟机与宿主机的网络拓扑是NAT形式。实际中,许多开发者更希望使用网桥模式。 //vnc端口系统自动配置
六、libvirt的使用——头文件与编译
#include "libvirt/libvirt.h" //libvirt主要API
#include <libvirt/virterror.h> //libvirt 错误提示
编译时加入连接库 -lvirt,例如我要编译名为createvm.cpp的源文件,可以运行如下命令g++ createvm.cpp -o createvm -lvirt。
七、主要使用的API
这里只列举一些常用的API,具体可参见libvirt API开发手册
主要功能 | 函数原型 |
创建连接 | virConnectPtr virConnectOpen(const char * name) |
根据xml文档创建虚拟机 | virDomainPtr virDomainCreateXML(virConnectPtr conn, const char * xmlDesc, unsigned int flags) |
根据虚拟机名字获得虚拟域 | virDomainPtr virDomainLookupByName(virConnectPtr conn, const char * name) |
获取虚拟域相关信息 | int virDomainGetInfo(virDomainPtr domain, virDomainInfoPtr info) |
关闭虚拟域 | int virDomainShutdown (virDomainPtr domain) |
销毁虚拟域 | int virDomainDestroy (virDomainPtr domain) |
八、新建虚拟机
备注:这里只是写一个简单的例子,除print.cpp以外的代码没有写成带参数、可配置的,请见谅。
/* createvm.cpp */ /* compile with: g++ createvm.cpp -o createvm -lvirt */ /* Wang Min @ iie */ /* autumn_sky_is@163.com */ /* date: 2013-02-27 */ #include#include #include #include #include // for stringstream #include "libvirt/libvirt.h" #include using namespace std; string vm_xml_location = "../xml/template.xml"; int main() { ifstream file(vm_xml_location.c_str()); if (!file) { cout<<"Cannot open file "< < message << endl; return -1; } return 0; }
编译后,直接运行./createvm,就创建了一个名为demo的kvm 虚拟机。需要预先在相应目录下新建好一个名为“template.xml”的配置文件
九、读取虚拟机信息
/* print.cpp */ /* compile with: g++ print.cpp -o print -lvirt */ /* Wang Min @ iie */ /* autumn_sky_is@163.com */ /* date: 2013-02-27 */ #include#include #include #include #include // for stringstream #include "libvirt/libvirt.h" #include using namespace std; //using namespace rapidxml; int main(int argc, char * argv[]) { if (2 != argc){ cout << "Error: print need 1 parametre" << endl; cout << "usage: ./print vm_name" << endl; return -1; } virConnectPtr conn = virConnectOpen("lxc:///"); if (NULL == conn) { fprintf(stderr, "Failed to build connection to lxc:///.\n"); return -1; } virDomainPtr domain = virDomainLookupByName(conn, argv[1]); if (domain == NULL){ cout << "can not find " << argv[1] << ", regard it as success." << endl; return -1; } // get lxc Info virDomainInfo info; if (-1 == virDomainGetInfo(domain, &info)){ cout << "can not get domain info" << endl; return -1; } printf("state:%d|maxmem:%d|memused:%d|cpunum:%d|cputime:%ld\n", info.state, info.maxMem, info.memory, info.nrVirtCpu, info.cpuTime); cout << "Helloworld" << endl; return 0; }
编译后运行./print virt_name,例如./print demo
十、关闭虚拟机
/* shutdownvm.cpp */ /* compile with: g++ shutdownvm.cpp -o shutdownvm -lvirt */ /* Wang Min @ iie */ /* autumn_sky_is@163.com */ /* date: 2013-02-27 */ #include#include #include #include #include // for stringstream #include "libvirt/libvirt.h" #include using namespace std; string domname = "demo"; int main() { virConnectPtr conn = virConnectOpen("qemu:///system"); if(NULL==conn) { fprintf(stderr, "Failed to build connection to qemu:///system.\n"); return -1; } virDomainPtr domain = virDomainLookupByName(conn, domname.c_str()); if (domain == NULL){ cout << "can not find " << domname << ", regard it as success." << endl; return 0; } if (virDomainShutdown(domain) != 0){ virErrorPtr error = virGetLastError(); cout << error->message << endl; return -1; } return 0; }
编译后运行./shutdownvm
十一、销毁虚拟机
/* destroyvm.cpp */ /* compile with: g++ destroyvm.cpp -o destroyvm -lvirt */ /* Wang Min @ iie */ /* autumn_sky_is@163.com */ /* date: 2013-02-27 */ #include#include #include #include #include // for stringstream #include "libvirt/libvirt.h" #include using namespace std; string domname = "demo"; int main() { virConnectPtr conn = virConnectOpen("qemu:///system"); if (NULL == conn) { fprintf(stderr, "Failed to build connection to qemu:///system.\n"); return -1; } virDomainPtr domain = virDomainLookupByName(conn, domname.c_str()); if (domain == NULL){ cout << "can not find " << domname << ", regard it as success." << endl; return 0; } if (virDomainDestroy(domain) != 0){ virErrorPtr error = virGetLastError(); cout << error->message << endl; return -1; } return 0; }
编译后运行./destroyvm