consul-dnsmasq

Installs and Configures [Hashicorp's Consul] (https://consulproject.io) cluster with DNSMasq and Web UI.

It uses ansible inventory and playbook for flexibility to configure the whole cluster.

INFO: This role relies heavily in the Ansible Inventory file, it assumes that each node is already created with DNS names assigned to them. I uses the names declared in the inventory file to generate the configuration to be pushed, still getting the head around Ansible best practices, any feedback is appreciated. The role assumes that NGINX and DNSMasq is installed using the default Ubuntu packages and expects Consul to be installed and available PATH, usually /usr/local/bin/. We recommend use the role marcelocorreia.hashicorp-pack and marcelocorreia.apt to install these dependencies, but you're free to use any other method.

Inventory Example

bootstrap[1:2].local ansible_connection=ssh ansible_ssh_user=ubuntu ansible_ssh_private_key_file=~/.ssh/key.pem
server[1:3].local ansible_connection=ssh ansible_ssh_user=ubuntu ansible_ssh_private_key_file=~/.ssh/key.pem
client[1:13].local ansible_connection=ssh ansible_ssh_user=ubuntu ansible_ssh_private_key_file=~/.ssh/key.pem
anotherclient.com ansible_connection=ssh ansible_ssh_user=ubuntu ansible_ssh_private_key_file=~/.ssh/key.pem

[consul-bootstrap]
bootstrap[1:2].local

[consul-servers]
server[1:3].local

[consul-clients]
worker[1:13].local
anotherclient.local
wholebunchofclients[1:50].whatever.io

Encryption Key Generation

$ consul keygen

Role Variables

consul_nginx_redir_by_hostname: "{{ consul_nginx_redir_by_hostname | default('true') }}"
consul_nginx_port: "{{ consul_nginx_port | default('80') }}"
consul_datacenter: central
consul_uid: 1050
consul_user: consul
consul_group: consul
consul_iface: eth1
consul_ip: 127.0.0.1
consul_log_level: info
consul_port: 8600
consul_suffix: consul
consul_ui_dir: /var/consul/ui
consul_version: 0.5.2
consul_encrypt_key: 2M2aASKoKGek05TjpHcsuw==

Example Playbook

---
  - hosts:
      - consul-bootstrap
      - consul-servers
      - consul-clients
    sudo: no
    gather_facts: true

    roles:
      - marcelocorreia.consul-dnsmasq

    vars_files:
      - /some_path/vars/consul.yml

    vars:
      consul_datacenter: dc1
      consul_uid: 1050
      consul_user: consul
      consul_group: consul
      consul_iface: eth1
      consul_ip: 127.0.0.1
      consul_log_level: info
      consul_port: 8600
      consul_suffix: consul
      consul_ui_dir: /var/consul/ui
      consul_version: 0.5.2
      consul_encrypt_key: 2M2aASKoKGek05TjpHczuw==

Testing

Using this small Vagrant cluster

# -*- mode: ruby -*-
# vi: set ft=ruby :


Vagrant.configure('2') do |config|
  config.vm.provision 'shell', inline: 'echo Ansible Consul POC'

  config.vm.define 'consulBootstrap1' do |consulBootstrap1|
    consulBootstrap1.vm.box = 'ubuntu/trusty64'
    consulBootstrap1.vm.box_url = '.'
    consulBootstrap1.vm.hostname = 'consulBootstrap1'
    consulBootstrap1.vm.network 'public_network', bridge: "eth1"
    consulBootstrap1.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulBootstrap2' do |consulBootstrap2|
    consulBootstrap2.vm.box = 'ubuntu/trusty64'
    consulBootstrap2.vm.box_url = '.'
    consulBootstrap2.vm.hostname = 'consulBootstrap2'
      consulBootstrap2.vm.network 'public_network', bridge: "eth1"
    consulBootstrap2.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulServer1' do |consulServer1|
    consulServer1.vm.box = 'ubuntu/trusty64'
    consulServer1.vm.box_url = '.'
    consulServer1.vm.hostname = 'consulServer1'
    consulServer1.vm.network 'public_network', bridge: "eth1"
    consulServer1.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulServer2' do |consulServer2|
    consulServer2.vm.box = 'ubuntu/trusty64'
    consulServer2.vm.box_url = '.'
    consulServer2.vm.hostname = 'consulServer2'
    consulServer2.vm.network 'public_network', bridge: "eth1"
    consulServer2.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulServer3' do |consulServer3|
    consulServer3.vm.box = 'ubuntu/trusty64'
    consulServer3.vm.box_url = '.'
    consulServer3.vm.hostname = 'consulServer3'
    consulServer3.vm.network "public_network", bridge: "eth1"
    consulServer3.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulClient1' do |consulClient1|
    consulClient1.vm.box = 'ubuntu/trusty64'
    consulClient1.vm.box_url = '.'
    consulClient1.vm.hostname = 'consulClient1'
    consulClient1.vm.network 'public_network', bridge: "eth1"
    consulClient1.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end

  config.vm.define 'consulClient2' do |consulClient2|
    consulClient2.vm.box = 'ubuntu/trusty64'
    consulClient2.vm.box_url = '.'
    consulClient2.vm.hostname = 'consulClient2'
    consulClient2.vm.network 'public_network', bridge: "eth1"
    consulClient2.vm.provider 'virtualbox' do |vb|
      # vb.gui = true
      vb.memory = '512'
      vb.cpus = 1
    end
  end
end

License

MIT

Author Information

Some useful stuff at:

• https://github.com/marcelocorreia
• https://galaxy.ansible.com/list#/users/15516
• https://hub.docker.com/u/marcelocorreia/
• Any issues, pull-request are welcome