Skip to content

Latest commit

 

History

History
105 lines (81 loc) · 3.91 KB

README_VAGRANT.md

File metadata and controls

105 lines (81 loc) · 3.91 KB
Raw

Nomad with Ansible

This project provides documentation and a collection of scripts to help you automate the deployment of Nomad using Ansible. These are the instructions for deploying a development cluster on Vagrant and VirtualBox.

The documentation and scripts are merely a starting point designed to both help familiarize you with the processes and quickly bootstrap an environment for development. You may wish to expand on them and customize them with additional features specific to your needs later.

Vagrant Development Cluster

In some situations deploying a small cluster on your local development machine can be handy. This document describes such a scenario using the following technologies:

Each of the virtual machines for this guide are configured with 1.5GB RAM, 2 CPU cores, and 2 network interfaces. The first interface uses NAT and has connection via the host to the outside world. The second interface is a private network and is used for nomad intra-cluster communication in addition to access from the host machine.

The Vagrant configuration file (Vagrantfile) is responsible for configuring the virtual machines and a baseline OS installation.

The Ansible playbooks then further refine OS configuration, perform nomad software download and installation, and the initialization of nodes into a ready to use cluster.

Designed for Ansible Galaxy

This role is designed to be installed via the ansible-galaxy command instead of being directly run from the git repository.

You should install it like this:

ansible-galaxy install brianshumate.nomad

You'll want to make sure you have write access to /etc/ansible/roles/ since that is where the role will be installed by default, or define your own Ansible role path by creating a $HOME/.ansible.cfg or even ./anisible.cfg file with these contents:

[defaults]
roles_path = PATH_TO_ROLES

Change PATH_TO_ROLES to a directory that you have write access to.

Quick Start

Begin from the top level directory of this project and use the following steps to get up and running:

  1. Install VirtualBox, Vagrant, vagrant-hosts, and Ansible.
  2. Edit /etc/hosts or use the included bin/preinstall script to add the following entries to your development system's /etc/hosts file:
  • 10.1.42.70 nomad1.local nomad1
  • 10.1.42.71 nomad2.local nomad2
  • 10.1.42.72 nomad3.local nomad3
  1. cd $PATH_TO_ROLES/brianshumate.conusul/examples
  2. vagrant up

By default, this project will install Debian 8 based cluster nodes. If you prefer, it can also install CentOS 7 based nodes by changing the command in step 4 to the following:

BOX_NAME="centos/7" vagrant up

Notes

  1. This project functions with the following software versions:
  • Nomad version 0.12.1
  • Ansible version 2.8.0
  • VirtualBox version 5.2.30
  • Vagrant version 2.2.4
  • Vagrant Hosts version 2.8.3
  1. This project uses Debian 8 (Jessie) by default, but you can choose other OS with the BOX_NAME environment variable
  2. The bin/preinstall shell script performs the following actions for you:
  • Adds each node's host information to the host machine's /etc/hosts
  • Optionally installs the Vagrant hosts plugin
  1. If you see an error like vm: The '' provisioner could not be found. make sure you have vagrant-hosts plugin installed

References

  1. https://www.nomadproject.io/
  2. http://www.ansible.com/
  3. http://www.vagrantup.com/
  4. https://www.virtualbox.org/
  5. https://github.com/adrienthebo/vagrant-hosts