mirror of
https://github.com/vagrant-libvirt/vagrant-libvirt.git
synced 2025-02-25 18:55:27 -06:00
24 lines
839 B
Markdown
24 lines
839 B
Markdown
# 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.
|
|
|