From 33417a28c57d1b4b8b05adde72ee039328242915 Mon Sep 17 00:00:00 2001 From: Eric Fode Date: Wed, 5 Nov 2014 12:55:53 -0800 Subject: [PATCH] Update README.md Added basic Getting started --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 0748649e..a6d3b5ed 100644 --- a/README.md +++ b/README.md @@ -271,6 +271,15 @@ Include `consul::ui` in your node's `run_list`: action :delete end +#### Getting Started +To bootstrap a consul cluster follow the following steps: +1. Bootstrap a few (preferablly 3 nodes) to be your consul servers, these will be the KV masters. +2. Put `node['consul']['servers'] =["Array of the bootstrapped servers ips or dns names"]` in your environment. +2. Apply the consul cookbook to these nodes with `node['consul']['service_mode'] = 'cluster'` (I put this in this in a CONSUL_MASTER role). +3. Let these machines converge, once you can run `consul members` and get a list of all of the servers your ready to move on +4. Apply the consul cookbook to the rest of your nodes with `node['consul']['service_mode'] = 'client'` (I put this in the environment) +5. Start added services and checks to your cookbooks. +6. If you want to get values out of consul to power your chef, curl localhost:8500/v1/kv/key/path?raw in your cookbook. ## Authors Created and maintained by [John Bellone][3] [@johnbellone][2] () and a growing community of [contributors][4].