Skip to content
This repository has been archived by the owner on Mar 17, 2023. It is now read-only.

ivangrynenko/beetbox

 
 

Repository files navigation

Beetbox - a pre-provisioned L*MP stack

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 build time, but also to reduce the size of each VM by leveraging linked clones.

Whilst it contains a set of default features, 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.

Circle CI Documentation Status

Why not use Drupal VM / Vlad?

  • 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.

Requirements

vagrant plugin install vagrant-hostsupdater
vagrant plugin install vagrant-auto_network

Quickstart

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

Drupal Quickstart

To get a simple Drupal 8 site up and running with Beetbox, run the following commands:

drush pm-download drupal-8 --drupal-project-rename=drupal8 && cd drupal8
php -r "readfile('https://raw.githubusercontent.com/beetboxvm/beetbox/master/Vagrantfile');" > Vagrantfile
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.

Project roles.

These roles are mantained by Beetbox team.

Project Build status
Backdrop Circle CI
CakePHP CircleCI
Drupal CircleCI
Kohana CircleCI
Modx CircleCI
Silverstripe CircleCI
Slim CircleCI
Symfony Circle CI
Wordpress CircleCI

Documentation

http://beetbox.readthedocs.io/en/latest/

Contributing

http://beetbox.readthedocs.io/en/latest/contributing/contributing/

Support

Credits

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.

License

This project is licensed under the MIT open source license.

About

The multi CMS L*MP stack

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 46.0%
  • Shell 29.2%
  • PHP 24.8%