A VirtualBox image for Mastodon development
This VirtualBox base image contains all the required packages and configuration for running/instantiating a Mastodon instance for development. It is build using Hashicorp's Packer, the provisioning is done with Ansible through a dedicated git submodule called mastodon-ansible. The tests are using ServerSpec. The image is build continuously using Hashicorp Atlas.
Note: Some of the content of the scripts in scripts/
is borrowed from the Bento project.
Prerequisites (for building on your own)
- VirtualBox >= 5.1.x
- Packer >= 1.0.0
- Python >= 2.x
- pip/python-pip >= 8.x
for testing purposes:
- Vagrant >= 1.9.3
Setup
$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt
Building the box locally
Just execute:
$ packer build packer.local.json
Note: It will take at least roughly 5 - 10 minutes for the ISO to get preseeded ("pre-provisioned") by the Debian installer, hence the rather long timeout/waiting period before packer actually starts provisioning. If you're unsure whether there is any progress change the values headless
in the packer.json
from true
to false
and re-run the process. This will give have VirtualBox show you the output of the console the ISO is running on.
This will preseed the Ubuntu ISO image for Ubuntu Xenial 64bit with a couple of sane defaults and packages. Afterwards, the Ansible provisioner is run using the playbooks from the mastodon-ansible repository.
In the end you should have a box in builds/
with all the required components installed you can run directly in Vagrant.
Submitting to Atlas
HashiCorp's Atlas can be used to build new boxes. Usually it's either very difficult or impossible to build them on other SaaS offerings (because you need a fully virtualized environment to run VirtualBox). To push a new configuration to Atlas run:
$ packer push -token=<your-token> packer.atlas.json
Only files that are checked into git are uploaded/submitted to Packer Enterprise (i.e. everything in .gitignore
stays where it is).
Note: There is a organization within Packer Enterprise called mastodon
which is responsible for the Vagrant boxes under the same namespace. If you think you can/want to contribute send me a message on @moritzheiber@mastodon.social and I'll add your to the organization. This GitHub repository is bound to the Packer Enterprise configuration mastodon/ubuntu-xenial64
and will trigger a new build for each commit.
Testing
TODO