Browse Source

improve documentation regarding docker cluster

instead of trying to highlight stuff within markdown code blocks, this commits adds a descriptive sentence explaining the differences.
tobilarscheid 9 years ago
parent
commit
3d97da0672
1 changed files with 18 additions and 16 deletions
  1. 18 16
      Documentation/v2/docker_guide.md

+ 18 - 16
Documentation/v2/docker_guide.md

@@ -42,53 +42,55 @@ etcdctl -C http://192.168.12.50:4001 member list
 Using Docker to setup a multi-node cluster is very similar to the standalone mode configuration.
 The main difference being the value used for the `-initial-cluster` flag, which must contain the peer urls for each etcd member in the cluster.
 
+**Although the following commands look the same, please note that _-name_, _-advertise-client-urls_ and _-initial-advertise-peer-urls_ differ between the cluster members!**
+
 ### etcd0
 
-<pre>
+```
 docker run -d -v /usr/share/ca-certificates/:/etc/ssl/certs -p 4001:4001 -p 2380:2380 -p 2379:2379 \
  --name etcd quay.io/coreos/etcd \
- <b>-name etcd0</b> \
- <b>-advertise-client-urls http://192.168.12.50:2379,http://192.168.12.50:4001</b> \
+ -name etcd0 \
+ -advertise-client-urls http://192.168.12.50:2379,http://192.168.12.50:4001 \
  -listen-client-urls http://0.0.0.0:2379,http://0.0.0.0:4001 \
- <b>-initial-advertise-peer-urls http://192.168.12.50:2380</b> \
+ -initial-advertise-peer-urls http://192.168.12.50:2380 \
  -listen-peer-urls http://0.0.0.0:2380 \
  -initial-cluster-token etcd-cluster-1 \
  -initial-cluster etcd0=http://192.168.12.50:2380,etcd1=http://192.168.12.51:2380,etcd2=http://192.168.12.52:2380 \
  -initial-cluster-state new
-</pre>
+```
 
 ### etcd1
 
-<pre>
+```
 docker run -d -v /usr/share/ca-certificates/:/etc/ssl/certs -p 4001:4001 -p 2380:2380 -p 2379:2379 \
  --name etcd quay.io/coreos/etcd \
- <b>-name etcd1</b> \
- <b>-advertise-client-urls http://192.168.12.51:2379,http://192.168.12.51:4001</b> \
+ -name etcd1 \
+ -advertise-client-urls http://192.168.12.51:2379,http://192.168.12.51:4001 \
  -listen-client-urls http://0.0.0.0:2379,http://0.0.0.0:4001 \
- <b>-initial-advertise-peer-urls http://192.168.12.51:2380</b> \
+ -initial-advertise-peer-urls http://192.168.12.51:2380 \
  -listen-peer-urls http://0.0.0.0:2380 \
  -initial-cluster-token etcd-cluster-1 \
  -initial-cluster etcd0=http://192.168.12.50:2380,etcd1=http://192.168.12.51:2380,etcd2=http://192.168.12.52:2380 \
  -initial-cluster-state new
-</pre>
+```
 
 ### etcd2
 
-<pre>
+```
 docker run -d -v /usr/share/ca-certificates/:/etc/ssl/certs -p 4001:4001 -p 2380:2380 -p 2379:2379 \
  --name etcd quay.io/coreos/etcd \
- <b>-name etcd2</b> \
- <b>-advertise-client-urls http://192.168.12.52:2379,http://192.168.12.52:4001</b> \
+ -name etcd2 \
+ -advertise-client-urls http://192.168.12.52:2379,http://192.168.12.52:4001 \
  -listen-client-urls http://0.0.0.0:2379,http://0.0.0.0:4001 \
- <b>-initial-advertise-peer-urls http://192.168.12.52:2380</b> \
+ -initial-advertise-peer-urls http://192.168.12.52:2380 \
  -listen-peer-urls http://0.0.0.0:2380 \
  -initial-cluster-token etcd-cluster-1 \
  -initial-cluster etcd0=http://192.168.12.50:2380,etcd1=http://192.168.12.51:2380,etcd2=http://192.168.12.52:2380 \
  -initial-cluster-state new
-</pre>
+```
 
 Once the cluster has been bootstrapped etcd clients can be configured with a list of etcd members:
 
 ```
 etcdctl -C http://192.168.12.50:2379,http://192.168.12.51:2379,http://192.168.12.52:2379 member list
-```
+```