Ansible Workshop Deploy

Requirements

This application is developed with Vagrant 1.8.0 and Ansible 2.0 for a Debian 8 environment.

Setup

To run the application within a Vagrant environment, ensure that you have Vagrant and VirtualBox (or Parallels on OS X) installed.

Initial Setup

Git Repositories

You will need to clone this repository: git clone git@github.com:boltmade/ansible-workshop-deploy.git

You may also want to checkout the application being deployed: boltmade/ansible-workshop-app.

Initial Machine Setup

Thanks to the magic of Vagrant, this is dead simple:

cd ansible-workshop-deploy
vagrant up --provider=virtualbox # OR: vagrant up --provider=parallels

You can stop the application and halt the machine by running vagrant halt or suspend the machine by running vagrant suspend.

Working with the Machine

If you need to apply any updates to your vagrant machine:

vagrant provision

To access the machine:

vagrant ssh

To verify everything is okay:

ansible-playbook --version # => 2.0.1.0

Deployment

We use Ansible to manage our deployments. The vagrant machine comes with this installed.

Setup

Galaxy Roles

If ansible complains about a missing galaxy role, simply run:

ansible-galaxy install -r playbooks/requirements.txt

These are automatically installed during vagrant provision and within the vagrant environment on machine setup.

Production

Run inside the Vagrant VM:

ansible-playbook playbooks/site.yml -i playbooks/production

If you want to refresh the database, append --extra-vars "should_seed=true"

Dry Run

If you wish to view what would happen without making changes you can perform a trial run and, optionally, request a diff to see the changes, simply append:

--check [--diff]