1tuan1 / drop

Vagrant environment for new and existing Drupal projects

Vagrant Drupal

Vagrant allows you to set up a virtualized development environment. This project will help you setup a ready to develop environment for a new or existing Drupal project.

Box specifications

• Nginx
• Mariadb
• PHP
• Postfix
• Git
• Curl
• Node.js
• Composer
• Bower
• Drush
• Sass
• Compass
• Gulp
• Grunt
• Adminer
• Xdebug
• XHProf
• Mailcatcher

Installation steps

1. Download and Install Vagrant and VirtualBox.
2. Download/clone this repository
3. Run the command: site=d7 vagrant up
4. Go to drop.local
5. Login with user admin and password admin

Work on an existing Drupal project

1. Download/clone this repository
2. Copy your project source code in www/htdocs
3. Copy your database file (extension .sql or .sql.gz) in www/init/backup.
4. Type restore=mydatabasefile.sql.gz vagrant up or restore=latest vagrant up.

Drupal profiles and custom website installs.

Site scripts can be executed by using the custom Vagrant environment variable 'site'. The current site scripts found in the scripts folder are currently setup scripts for a new Drupal 7 website. You can however create your own. Please use the format 'mycustomsite.sh' as script name in the scripts folder. And you will be able to run site=mycustomsite vagrant up.

More available commands:

• site=d7 vagrant up: Default installation of a vanilla Drupal 7 website
• site=d8 vagrant up: Default installation of a vanilla Drupal 8 website
• site=d7profile vagrant up: An example profile used for starting new Drupal 7 websites.

Box updates

The first time you will run this repository it will download the latest available base box. Afterwards it could be that the vagrant box can receive bug and improvement updates. Vagrant will automatically check if a new version of the base box is available everytime you run the command 'vagrant up'. Execute the command vagrant box update --box iampuma/drop to update the base box.

The version changelog can be found at https://atlas.hashicorp.com/iampuma/boxes/drop

Custom box build

The iampuma/drop box is created from a ubuntu/trusty32 base box with the create-box bash script found in the scripts folder. Create your own box by using the 'build' Vagrant environment variable. Firstly change the build script if wanted and build your box with the command build=true vagrant up.

Features by plugin extensions

• Vagrant triggers allows taking a backup on every 'vagrant destroy' which you will find in the 'www/init/backup' folder.
• Vagrant winnfsd enables Windows users to use NFS file mounting.
• Vagrant hostmanager manages the /etc/hosts file on guests within a multi-machine environment.

Roadmap

• Add sass and compass
• Another seperate provisioner for default Drupal setup
• Add possibility for custom build boxes
• Add automatic database backup after vagrant destroy
• Add latest database restore
• Add a Drupal 8 installation
• Add a Drupal 7 profile
• Add Gulp and Grunt cli
• Add Xdebug and XHProf
• Add Adminer
• Add Mailcatcher
• Add a Drupal 8 profile
• Add Packer template for box creation

FAQ

• Why use the vagrant-winnfsd plugin?

As Drupal contains a lot of files, it would be running slow without NFS. Windows users do not have native NFS support, this plugin covers that.

• I get this warning on Windows "Vagrant is attempting to interface with the UI in a way that requires a TTY."

Then do the following: http://stackoverflow.com/questions/23633276/vagrant-is-attempting-to-interface-with-the-ui-in-a-way-that-requires-a-tty#answer-32398981

• I am hanging on "Mounting NFS shared folders..."*

On OSX enable Automatically allow signed software to receive incoming connections, see wunki/vagrant-freebsd#4 (comment).

• Drupal "drush bam-backup" is not working with compression

This is currently a known problem in php5.5 on 32bit systems. I will fix this as soon as there is a fix.