Vagrant is a brilliant tool, used by DevOps professionals, coders, sysadmins and regular geeks to stand up repeatable infrastructure for development and testing. From their website:
Vagrant is a tool for building and managing virtual machine environments in a single workflow. With an easy-to-use workflow and focus on automation, Vagrant lowers development environment setup time, increases production parity, and makes the “works on my machine” excuse a relic of the past.
If you are already familiar with the basics of Vagrant, the documentation provides a better reference build for all available features and internals.
Vagrant provides easy to configure, reproducible, and portable work environments built on top of industry-standard technology and controlled by a single consistent workflow to help maximize the productivity and flexibility of you and your team.
This guide will walk through the steps necessary to get Vagrant working on a Fedora-based machine.
I started with a minimal install of Fedora Server as this reduces the memory footprint of the host OS, but if you already have a working Fedora machine, either Server or Workstation, then this should still work.
Check the machine supports virtualisation:
$ sudo lscpu | grep Virtualization Virtualization: VT-x Virtualization type: full
sudo dnf install qemu-kvm libvirt libguestfs-tools virt-install rsync
Enable and start the libvirt daemon:
sudo systemctl enable --now libvirtd
sudo dnf install vagrant
Install the Vagrant libvirtd plugin:
sudo vagrant plugin install vagrant-libvirt
Add a box
vagrant box add fedora/32-cloud-base --provider=libvirt
Create a minimal Vagrantfile to test
$ mkdir vagrant-test $ cd vagrant-test $ vi VagrantfileVagrant.configure("2") do |config| config.vm.box = "fedora/32-cloud-base" end
Note the capitalisation of the file name and in the file itself.
Check the file:
vagrant statusCurrent machine states: default not created (libvirt) The Libvirt domain is not created. Run 'vagrant up' to create it.
Start the box:
Connect to your new machine:
That’s it – you now have Vagrant working on your Fedora machine.
To stop the machine, use vagrant halt. This simply halts the machine but leaves the VM and disk in place.
To shut it down and delete it use vagrant destroy. This will remove the whole machine and any changes you’ve made in it.
You don’t need to download boxes before issuing the vagrant up command – you can specify the box and the provider in the Vagrantfile directly and Vagrant will download it if it’s not already there. Below is an example which also sets the amount memory and number of CPUs:
# -*- mode: ruby -*- # vi: set ft=ruby : Vagrant.configure("2") do |config| config.vm.box = "fedora/32-cloud-base" config.vm.provider :libvirt do |libvirt| libvirt.cpus = 1 libvirt.memory = 1024 end end
For more information on using Vagrant, creating your own machines and using different boxes, see the official documentation at https://www.vagrantup.com/docs
There is a huge repository of boxes ready to download and use, and the official location for these is Vagrant Cloud – https://app.vagrantup.com/boxes/search. Some are basic operating systems and some offer complete functionality such as databases, web servers etc.