NuKVM/vagrant-libvirt
3
0
Fork 0
mirror of https://github.com/vagrant-libvirt/vagrant-libvirt.git synced 2025-01-07 14:33:08 -06:00
Code Issues Packages Projects Releases Wiki Activity
26e25c0191
vagrant-libvirt/example_box
History
Darragh Bailey 18ebb9d9ed
Enable frozen string across project (#1319) 
Turn on frozen string support in all files by using a comment to avoid
enabling across dependencies where it may not work.

Fixes: #1177
2021-06-30 13:27:03 +01:00
..
metadata.json works 2015-09-23 20:37:24 -06:00
README.md Updated Libvirt-based Vagrant box search reference and edited names for consistency 2019-02-11 20:18:02 -05:00
Vagrantfile Enable frozen string across project (#1319) 2021-06-30 13:27:03 +01:00

README.md

Vagrant Libvirt Example Box

Vagrant providers each require a custom provider-specific box format. This folder shows the example contents of a box for the libvirt provider. To turn this into a box create a Vagrant image according documentation (don't forget to install rsync command) and create box with following command:

$ tar cvzf custom_box.box ./metadata.json ./Vagrantfile ./box.img

This box works by using Vagrant's built-in Vagrantfile merging to setup defaults for Libvirt. These defaults can easily be overwritten by higher-level Vagrantfiles (such as project root Vagrantfiles).

Box Metadata

Libvirt box should define at least three data fields in metadata.json file.

  • provider - Provider name is libvirt.
  • format - Currently supported format is qcow2.
  • virtual_size - Virtual size of image in GBytes.

Converting Boxes

Instead of creating a box from scratch, you can use vagrant-mutate to take boxes created for other Vagrant providers and use them with vagrant-libvirt.