Jekyll Dev Environment for Vagrant

About

This is a simple Vagrantfile and Ansible playbook to deploy a development environment for a Jekyll powered website, such as Github Pages. Vagrant allows you to quickly build and destroy development environments, while the Ansible provisioner deploys the required packages and clones the appropriate Github repo. Out of the box, the dev environment uses VirtualBox provider, but one could edit the Vagrantfile for any other provider such as VMware, or EC2.

The Vagrant box used is the official CentOS release which does not include the VirtualBox guest editions, so if you prefer, you can choose a different CentOS box.

The ./provisioning/playbook.yml Ansible playbook deploys the following packages with Yum:

Extra Packages for Enterprise Linux (EPEL)
Ruby
Ruby development packages
Ruby gems
NPM
Vim
Git

Additionally, the playbook uses the Github Pages ruby gem, which installs all of the dependencies for GitHub Pages, matching the current running versions on the Pages platform.

Requirements

The following software is required for a vanilla use of this dev environment:

Vagrant - https://vagrantup.com
Ansible - http://www.ansible.com

Usage

Clone the Git repo to a local directory

 git clone https://github.com/MrThePlague/jekyll-blog-dev.git

Change directory to the project folder
```
 cd jekyll-blog-dev
```
Run vagrant up to build the development environment
Use vagrant ssh to connect to the development box
Run the Jekyll development server, and listen on the box's default IP address
```
 jekyll serve -H 10.0.2.15 --incremental
```
When you're finished, commit and push your changes, and then run vagrant destroy on your host machine to clean up!