Skip to content

Commit

Permalink
Merge pull request #79 from ericfode/patch-2
Browse files Browse the repository at this point in the history
Update README.md with basic getting started
  • Loading branch information
johnbellone committed Nov 6, 2014
2 parents 0d96fc4 + 2eefb65 commit 9ed62cb
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -271,6 +271,17 @@ 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.
3. Apply the consul cookbook to these nodes with `node['consul']['service_mode'] = 'cluster'` (I put this in this in a CONSUL_MASTER role).
4. Let these machines converge, once you can run `consul members` and get a list of all of the servers your ready to move on
5. Apply the consul cookbook to the rest of your nodes with `node['consul']['service_mode'] = 'client'` (I put this in the environment)
6. Start added services and checks to your cookbooks.
7. 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] (<jbellone@bloomberg.net>) and a growing community of [contributors][4].
Expand Down

0 comments on commit 9ed62cb

Please sign in to comment.