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.
Metadata
Release files for vdisk 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vdisk-0.3.1.tar.gz | 13.7 kB | Without provenance | Details for vdisk-0.3.1.tar.gz |
Release files / vdisk-0.3.1.tar.gz
| Download URL | vdisk-0.3.1.tar.gz |
|---|---|
| Size | 13.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b18637f833006638254fd2d9bac20ba49f4897dcf538b3bc598048ca92f01215
|
|
BLAKE2b-256 checksum How to use checksums |
130e4acb5e287a7b2485f3d7a4caeed166a36aeec7355c002561e41690fb463e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for vdisk 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.