montlewis / perch-vagrant

Vagrant package for Perch sites

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

perch-vagrant

A simple packaged Vagrant environment for Perch sites. Not really Perch specific - it just sets up a simple LAMP environment and allows you to run multiple sites from one VM, rather than needing to run multiple VMs.

Uses hiera for the configuration so you just need to edit the Vagrantfile to get it running and then set up your sites in heira. No Puppet knowledge needed.

I built this on a Mac, there are people using this on Windows successfully but if you know of any issues let me know so I can fix them.

I'm using a Debian base box, the Puppet manifests are currently Debian only. I'm keeping this on Wheezy (old Stable) as by default that includes PHP 5.4, I'm using the dotdeb packages for newer PHPs. That is deliberate as so many Perch customers are stuck with old hosting with old PHP.

To run this

You need VirtualBox and Vagrant installed.

Git clone this box.

Edit the Vagrantfile, set the webroot to be the folder in which individual site folders live. This will be mapped to /var/www on the guest

Use an IP address not on your network. You will need to edit your hosts file or other internal DNS to map site URLs to that IP address.

The rest of your config happens via Hiera. In puppet/manifests/hiera/config.yaml you can set up some sites, databases and specify PHP.ini values.

The values for PHP Version should be one of:

  • 5.4
  • 5.5
  • 5.6

Put your site folders into the folder you specified in the Vagrantfile and set the docroot as /var/www/foldername

Save the config, run vagrant up.

About

Vagrant package for Perch sites


Languages

Language:HTML 94.8%Language:Puppet 4.7%Language:Groff 0.5%