Skip to content

A base CentOS vagrant setup good for SilverStripe and other PHP frameworks

License

Notifications You must be signed in to change notification settings

BetterBrief/vagrant-skeleton

Repository files navigation

Vagrant Skeleton

A bare bones repository to form a "as close as possible" base to a sensibly-configured live server to keep fragmentation of environments to a minimum. There is obviously the advantage of easily portable development environments!

This is a Vagrant skeleton that we used at Better Brief. It still gets used regularly so it's still somewhat regularly maintained.

Guest OS

We're using a CentOS 7 OS, image from chef (thanks)

However, there shouldn't be much issue using these scripts on the following OS's:

  • RHEL
  • Fedora
  • Amazon Linux

Automation and provisioning

We use as much automation as possible during provisioning so that our scripts can be used on other environments and not just on Vagrant boxes. Though it's important to note that some scripts rely on others, order of execution can be important and there are many setting changes that are designed for dev environments only.

Purpose

The main purpose for this skeleton is for developing SilverStripe sites (as that's our primary framework) so we include a basic environment file for that. However, the skeleton can easily be adapted for any other framework that you want to host on CentOS.

Requirements

You can use this system on any computer that can run the following software, it's completely platform independent.

Usage

To get up and running is very simple.

  1. Copy this repo to a new folder where you develop
  2. Add SQL dump(s) to the database folder with the name of the database the same as the filename
  3. Checkout your PHP code to a webroot folder:
  • www, public and public_html directories, where the full application lives inside the webroot (like SilverStripe), will be auto mounted
  • project/public directories will be auto mounted, where project contains your application, and the public folder contains any public facing code, like Laravel apps.
  • If no webroot is found, the latest SilverStripe will be installed in www
  1. Go to the command line and # vagrant up

This will run the default webserver with the default php modules we need installed. It will also pull in the database(s) automatically.

Customisations

Edit the Vagrantfile to enable or disable install scripts as they are required.

Included scripts and software

Script Name Version Repo Description
apache.sh Apache 2.x CentOS Mounts the www, public or public_html dir to webroot, installs Apache
php-54.sh PHP 5.3.x CentOS Installs PHP 5.4, restarts Apache
php-55.sh PHP 5.5.x Webtatic EL6 Installs PHP 5.5, restarts Apache
php-56.sh PHP 5.6.x Webtatic EL6 Installs PHP 5.6, restarts Apache
mariadb.sh MariaDB 5.5 MariaDB.org Installs MariaDB, opens port 3306, imports dumps in /vagrant/database
php-mcrypt.sh PHP Mcrypt extension - EPEL Installs Mcrypt. Only needed for PHP 5.3.x as 5.5 has it built-in.
xdebug.sh Xdebug extension - PECL Install Xdebug extension for debugging purposes.
ntp.sh ntp - CentOS Installs NTP which handles time management
node.sh NodeJS - Fedora EPEL Installs the NodeJS language and its package manager, NPM
bower.sh Bower - NPM Installs the Bower dependency manager
grunt.sh Grunt - NPM Installs the NodeJS based task runner, grunt.
grunt-watch.sh Grunt watch daemon - - Sets up an automatic grunt watch task that will run on vagrant up
composer.sh Composer - getcomposer.org Installs PHP's composer package manager
sspak.sh SSPak - Installs SSPak Asset and database snapshot tool for SilverStripe (link)
sass.sh Ruby, RubyGems, SASS 3.2.10 CentOS Installs SASS 3.4.10, a handy CSS pre processor, and Compass 1.0.3
bootstrap.sh - - - Various bootstrap tasks and snag fixes

Environments

Ideally we'd have scripts and configs that can be used on many environments (including live) however these are just local development environments and none of these are used on a live server.