A VM for local L*MP development, built with Packer, Vagrant + Ansible
Beetbox is essentially a pre-provisioned version of Drupal VM mainly to speed up initial virtual machine build time, but also to reduce the size of each VM by leveraging linked clones.
Whilst it contains a set of default feature configuration, it is extremely extensible and almost anything can be overridden/extended with a simple YAML config file.
It is designed to have an instance (VM) per project and be integrated into a VCS like git, so that configuration can be easily shared within a team and a setup of a new project should be as simple as git clone ...; vagrant up
.
This particular project contains the plumbing to manage the automated build of the pre-provisioned Vagrant base box, so almost all functionality is provided by ansible roles external to this project.
- It's a composer plugin which automatically creates a Vagrantfile.
- You only add config to your project and don't need to manage a fork of the whole provisioning system.
- It uses a pre-provisioned base box so it’s much faster to provision.
- Each new version of the box gets published to Atlas only if all roles are provisioned making the box always stable.
- With linked clones each VM is a small clone of a single master.
- You can reuse the same provisioning system for a CI environment.
- Minimal host machine dependencies.
vagrant plugin install vagrant-hostsupdater
vagrant plugin install vagrant-auto_network
composer require --dev beet/box
vagrant up
This will automatically generate a Vagrantfile and the .beetbox
directory, which will contain a config.yml
file used to configure overrides.
You can see some examples in config.yml
composer update beet/box
Version constraints should automatically keep you to the same minor release. (0.0.x)
However, you may need to update your configuation when upgrading minor releases. (0.x.0)
See the release notes for more information.
To get a simple Drupal 8 site up and running with Beetbox, run the following commands:
composer create-project drupal-composer/drupal-project:8.x-dev drupal8 --stability dev --no-interaction
cd drupal8
composer require --dev beet/box
vagrant up
After which you can install the site at http://drupal8.local/install.php
or add the following to ./beetbox/config.yml
and run vagrant provision
to automatically install drupal:
drupal_install_site: yes
drupal_account_name: admin
drupal_account_pass: admin
For PHP 7 add php_version: "7.0"
to ./beetbox/config.yml
, then run vagrant provision
.
These roles are mantained by Beetbox team.
Project | Build status |
---|---|
Backdrop | |
CakePHP | |
Drupal | |
Kohana | |
Modx | |
Silverstripe | |
Slim | |
Symfony | |
Wordpress |
http://beetbox.readthedocs.io/en/latest/
http://beetbox.readthedocs.io/en/latest/contributing/contributing/
- Feature requests should be created in the GitHub Beetbox Issue Queue.
- Bugs should be reported in the GitHub Beetbox Issue Queue.
- Use pull requests (PRs) to contribute to Beetbox.
This project would not be possible without geerlingguy's awesome Ansible roles from Drupal VM. We encourage you to support him by buying his book Ansible for DevOps.
Beetbox is primarily maintained by the Drupal Melbourne (Australia) community.
Please follow @beetboxvm for announcements.
This project is licensed under the MIT open source license.