This roq-vagrant repository is useful as a template, if you want to validate a specific configuration using a virtual machine.

A number of Linux distributions have been set up

  • CentOS 7 and 8

  • Debian 9 and 10

  • Ubuntu 18.04 and 20.04

These scripts are used to test roq-ansible (Ansible Roles) with different assumptions about Linux environments.


The latest major releases are typically being tested for a selection of Linux distributions.

Vagrant uses a Vagrantfile to configure the virtual machine, including an optional script for provisioning.

For example, the Ubuntu 18.04 Vagrantfile may look similar to this

Vagrant.configure("2") do |config| = "ubuntu/bionic64"
  config.vm.define "vm_test" "private_network", ip: ""
  config.vm.provider "virtualbox" do |vb|
    vb.customize ["modifyvm", :id, "--cpuexecutioncap", "50"]
    vb.memory = "4096"
    vb.cpus = 4
  end "forwarded_port", guest: 80, host: 10080
  config.vm.provision "shell" do |shell|
    shell.inline = "apt-get update && apt-get install -y python"
  config.vm.provision "ansible" do |ansible|
    ansible.inventory_path = "../vm_test"
    ansible.playbook = "../site.yml"

The assumption is that you are in this directory and your environment has access to

  • Vagrant

  • VirtualBox

  • Ansible Playbook

Then you can simply start the virtual machine by typings this

$ vagrant up


This will take some time!

The provisioning may fail (network timeout or other transient issue), in which case you can attempt to continue

$ vagrant provision

Once completed successfully, you can access your virtual machine

$ vagrant ssh

Finally, you can instruct your virtual machine to stop

$ vagrant halt