README

* COMMENT -*- mode: org -*-
#+Date: 2015-11-03
Time-stamp: <2016-01-04>

* make it easy to boot KVM VM on localhost.
User don't have to specify storage and config network themselves.

project code name: quickvm
cli: qvm

* Usage
Install dependencies, ask user to upgrade kernel maybe.

qvm init

boot a VM with default NAT network.
qvm --core 4 --ram 2048 --disk 20

boot a VM using existing tap device.
qvm [--network tap0] ...

choosing base OS image
qvm create myvm \
  --core 2 --ram 256 \
  --disk http://dfs.game.yy.com:8080/upload/u1404-vm4.img

// will download this from DFS or re-use local cache, then clone a new disk
image based on it.

qvm [--disk /path/to/xxx] ...
// clone root disk from given image.

Note: qvm requires root permission to create new dir/files and define new
domain.

* Configuration
image_service.type = DFS
image_service.url = http://xxx:xxx/

#image_service.type = ceph
#image_service.url = http://xxx:xxx/

image.default = u1204x64

* qvm data directories
- qvm data directories stores disk image and domain xml file.

  /data/qvm/images/
  /data/qvm/images/cirros-0.3.4-x86_64-disk.img
  /data/qvm/instances/
  /data/qvm/instances/vm1/disk
  /data/qvm/instances/vm1/domain.xml
  /data/qvm/instances/vm1/meta.iso
  /data/qvm/instances/vm1/meta/meta-data
  /data/qvm/instances/vm1/meta/user-data

  Auto create these dir in "qvm init" step if they do not exist.