BOXY

Boxy is a repository that we rely heavily on at stackzoo.
It basically contains vagrant scripts (hcl) and ansible playbooks that allow our engineers to quickly provision linux VMs.
Our members are free to follow the working method that best suits them but our advice is to always generate one (or more) VM per project/customer.

Prerequisites

• vagrant
• ansible
• virtualbox
• vagrant plugins (vagrant-disksize, vagrant-vbguest)

Note that, as of 10/03/2023, vagrant and virtualbox are not fully supported on macOS silicon and ansible does not run on Windows unless you are using WSL.
Given this preamble, we at stackzoo strongly recommend using a linux machine for development, preferably debian based, such as ubuntu.

Instructions

Clone this repo:

git clone https://github.com/stackzoo/boxy.git

apply the changes that best suit your needs and then spin up the provisioning:

vagrant up

Please note that the ansible playbook can also be executed against manually installed VM (eg. with vmware workstation or virtualbox).

Useful Commands

vagrant status — Get the current status of your VM

vangrant destroy — Remove all traces of the virtual machine from your system

vagrant suspend — Stop the machine and save its current state.

vagrant provision {vm-name} — Manually execute ansible playbook against a VM.

vagrant halt — Shut down the virtual machine.

vagrant box list - List local vagrant box images

vagrant box remove {vagrant-box-image-name} - Remove local vagrant box images

vagrant plugin list - List local vagrant plugins