https://github.com/stackzoo/boxy
Deploy dev VMs with minimum friction 📦 📦 📦
https://github.com/stackzoo/boxy
ansible development vagrant virtual-machine
Last synced: 8 months ago
JSON representation
Deploy dev VMs with minimum friction 📦 📦 📦
- Host: GitHub
- URL: https://github.com/stackzoo/boxy
- Owner: stackzoo
- Created: 2023-03-07T15:59:37.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-07T17:02:34.000Z (almost 3 years ago)
- Last Synced: 2025-03-26T13:11:16.971Z (9 months ago)
- Topics: ansible, development, vagrant, virtual-machine
- Homepage:
- Size: 16.6 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BOXY
[](https://github.com/stackzoo/boxy/actions/workflows/ansible-lint.yml)
**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:
```console
git clone https://github.com/stackzoo/boxy.git
```
apply the changes that best suit your needs and then spin up the provisioning:
```console
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