vagrant

What it does

How to write it

vagrant COMMAND [VM] [OPTIONS]

Main parts

Commands

init BOX

Make a Vagrantfile for a box.

up [VM]

Create and start the VMs.

ssh [VM]

Log in.

halt / reload / suspend / resume

Stop / restart / pause / continue.

destroy [-f]

Delete the VMs.

provision

Run the provisioning again.

status / global-status

State of the VMs here / everywhere.

snapshot save|restore|list NAME

Snapshots.

box add|list|update|remove

Manage boxes.

ssh-config

SSH settings (for ssh or Ansible).

Most used

Nothing matches this filter.

$ run as a normal user# run as root (or with sudo)

1. 1A first VM

   $vagrant init generic/rocky9
   $vagrant up
   $vagrant ssh

2. 2Two servers for an RHCSA lab

   $cat Vagrantfile
   Vagrant.configure("2") do |config|
     config.vm.box = "generic/rocky9"
     %w[server1 server2].each_with_index do |name, i|
       config.vm.define name do |s|
         s.vm.hostname = "#{name}.example.com"
         s.vm.network "private_network", ip: "192.168.56.#{10 + i}"
         s.vm.provider "virtualbox" do |v| v.memory = 2048; v.cpus = 2 end
       end
     end
   end
   $vagrant up

3. 3Provision with Ansible

   $cat Vagrantfile
   config.vm.provision "ansible" do |a|
     a.playbook = "site.yml"
   end
   $vagrant provision

4. 4Snapshot before a risky exercise

   $vagrant snapshot save server1 clean
   $vagrant snapshot restore server1 clean

5. 5Use KVM instead of VirtualBox

   $vagrant up --provider libvirt

6. 6SSH config for normal ssh and Ansible inventory

   $vagrant ssh-config > ssh.cfg
   $ssh -F ssh.cfg server1

7. 7Status of all VMs on this machine

   $vagrant global-status --prune

8. 8Restart and apply Vagrantfile changes

   $vagrant reload --provision

9. 9Stop at night, delete when done

   $vagrant halt
   $vagrant destroy -f

10. 10Update the base box

    $vagrant box update

Nothing matches this filter.

Files

Vagrantfile

The VM description (Ruby).

.vagrant/

Local state; add to .gitignore.

~/.vagrant.d/boxes/

Downloaded boxes.

Exit codes