Helper tool to build debian based virtual disks.
Project description
vdisk is a tool to create a debian system suitable for use by a virtualization technology such as kvm/qemu. The output image is is a sparse file holding a a partition table, the grub boot loader and a filesystem containing the base system.
Installation
vdisk is designed to run in Debian GNU/Linux and the standard configuration builds a Debian Squeeze image.
vdisk depends on a few packages being installed on the system where images are built. This can be accomplished by running the following command:
apt-get install kpartx parted lvm2 python-argparse
Functionality
vdisk builds sparse images and mounts them to loopback devices for convenient access.
This allows for easy manipulation of these images inside of a chroot, effectively letting allow for setup of a virtual base system without having to run a virtual machine.
Usage
All of the following commands must be run as root on a linux host.
vdisk expects a configuration file in the current working directory called vdisk.yaml, an example should be distributed with this package.
Build a fresh image and bootstrap a base system to it.
bin/vdisk foo.img create bin/vdisk foo.img bootstrap
Install required packages, and prepare image for booting.
bin/vdisk foo.img install [selections]
Try it out.
bin/vdisk foo.img enter
When you have a successfully installed a system, try it out using a virtual machine or an emulator like qemu.
qemu-system-x86_64 -hda foo.img -monitor stdio
EC2
You must include /boot/grub/menu.lst it in your vdisk.yaml. Simple example:
default 0 timeout 3 title EC2 root (hd0,0) kernel /vmlinuz root=/dev/mapper/VolFoo-root ro initrd /initrd.img
Depending on your kernel you might also need to create /etc/initramfs-tools/modules with xenblk and xennet modules, vdisk will execute update-initramfs as the final step.
Important Files
vdisk.yaml - Contains configuration for how to create your virtual disk.
License & Credits
This software is released under the GNU GPL, see COPYING for details.
It is authored by John-John Tedro <udoprog@spotify.com>, Noa Resare <noa@spotify.com> and Lars-Erik Stenholm <lasse@spotify.com>.
Copyright is held by Spotify AB.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file vdisk-0.3.1.tar.gz
.
File metadata
- Download URL: vdisk-0.3.1.tar.gz
- Upload date:
- Size: 13.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b18637f833006638254fd2d9bac20ba49f4897dcf538b3bc598048ca92f01215 |
|
MD5 | 6a5b9c380a032a7cb95ac741453580b0 |
|
BLAKE2b-256 | 130e4acb5e287a7b2485f3d7a4caeed166a36aeec7355c002561e41690fb463e |