README.md in percheron-0.8.0 vs README.md in percheron-0.8.1
- old
+ new
@@ -79,32 +79,32 @@
SUBCOMMAND subcommand
[ARG] ... subcommand arguments
Subcommands:
list, status List stacks and its units
- console Start a pry console session
start Start a stack
stop Stop a stack
restart Restart a stack
- build Build images for a stack
- create Build images and create units for a stack
- recreate Recreate a stack
+ build, rebuild (Re)build image(s) for a stack
+ create, recreate (Re)build image(s) and (re)create units for a stack
purge Purge a stack
shell Shell into a unit
logs Show logs for a unit
graph Generate a stack graph
Options:
-h, --help print help
-c, --config_file CONFIG Config file (default: ".percheron.yml")
- --version show version
+ --version show versionn
```
## Demo (using boot2docker)
1) Get boot2docker up and running
+Follow the directions at https://docs.docker.com/installation
+
```bash
boot2docker up && eval $(boot2docker shellinit) && export BOOT2DOCKER_IP=$(boot2docker ip)
```
2) Install percheron
@@ -124,18 +124,18 @@
- name: master
version: 1.0.0
docker_image: gliderlabs/consul-server:0.5
start_args: [ "-bootstrap", "-client", "0.0.0.0", "-data-dir", "/data", "-ui-dir", "/ui" ]
ports:
- - 8500:8500
- - 8600:53/udp
+ - "8500:8500"
+ - "8600:53/udp"
- name: agent
version: 1.0.0
instances: 2
docker_image: gliderlabs/consul-agent:0.5
start_args: [ "-join", "master" ]
- dependent_unit_names:
+ needed_unit_names:
- master
```
4) Start it up!
@@ -167,29 +167,29 @@
```
6) Ensure consul is running
```bash
-curl http://boot2docker:8500/v1/catalog/nodes
+curl http://${BOOT2DOCKER_IP}:8500/v1/catalog/nodes
[{"Node":"agent1","Address":"172.17.0.5"},{"Node":"agent2","Address":"172.17.0.6"},{"Node":"master","Address":"172.17.0.4"}]
```
7) Perform some DNS lookups using consul
```bash
-dig @boot2docker -p 8600 master.node.consul agent1.node.consul agent2.node.consul +short
+dig @${BOOT2DOCKER_IP} -p 8600 master.node.consul agent1.node.consul agent2.node.consul +short
172.17.0.7
172.17.0.8
172.17.0.9
```
8) Bring up the consul UI
```bash
-open http://boot2docker:8500/ui
+open http://${BOOT2DOCKER_IP}:8500/ui
```
9) Purge it!
```bash
@@ -210,13 +210,9 @@
```bash
percheron graph consul-stack
```
![consul-stack](https://raw.githubusercontent.com/ashmckenzie/percheron-consul/master/assets/stack.png)
-
-## Demo asciicast
-
-[![asciicast](https://asciinema.org/a/7l1ar35xlmfsaphhptrqvx7jg.png)](https://asciinema.org/a/7l1ar35xlmfsaphhptrqvx7jg)
## Debugging
To perform debugging you will need to install the `pry-byebug` gem: