Skip to main content

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

vdisk-0.3.1.tar.gz (13.7 kB view details)

Uploaded Source

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

Hashes for vdisk-0.3.1.tar.gz
Algorithm Hash digest
SHA256 b18637f833006638254fd2d9bac20ba49f4897dcf538b3bc598048ca92f01215
MD5 6a5b9c380a032a7cb95ac741453580b0
BLAKE2b-256 130e4acb5e287a7b2485f3d7a4caeed166a36aeec7355c002561e41690fb463e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page