From f7dc21773d92ed020fac1ad86068adaa541da973 Mon Sep 17 00:00:00 2001 From: email Date: Thu, 27 Jul 2017 14:40:52 +0200 Subject: [PATCH 01/13] new doc for weave --- README.md | 6 +++--- docs/weave.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+), 3 deletions(-) create mode 100644 docs/weave.md diff --git a/README.md b/README.md index e7e9245b6..3bc7c311c 100644 --- a/README.md +++ b/README.md @@ -53,12 +53,12 @@ Versions of supported components -------------------------------- -[kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.6.7
+[kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.6.4
[etcd](https://github.com/coreos/etcd/releases) v3.0.17
[flanneld](https://github.com/coreos/flannel/releases) v0.6.2
[calicoctl](https://github.com/projectcalico/calico-docker/releases) v0.23.0
[canal](https://github.com/projectcalico/canal) (given calico/flannel versions)
-[weave](http://weave.works/) v1.8.2
+[weave](http://weave.works/) v2.0.1
[docker](https://www.docker.com/) v1.13.1 (see note)
[rkt](https://coreos.com/rkt/docs/latest/) v1.21.0 (see Note 2)
@@ -91,7 +91,7 @@ You can choose between 4 network plugins. (default: `calico`) * [**canal**](https://github.com/projectcalico/canal): a composition of calico and flannel plugins. -* **weave**: Weave is a lightweight container overlay network that doesn't require an external K/V database cluster.
+* [**weave**](https://github.com/weaveworks/weave): Weave is a lightweight container overlay network that doesn't require an external K/V database cluster.
(Please refer to `weave` [troubleshooting documentation](http://docs.weave.works/weave/latest_release/troubleshooting.html)). The choice is defined with the variable `kube_network_plugin`. There is also an diff --git a/docs/weave.md b/docs/weave.md new file mode 100644 index 000000000..3c32d4d3a --- /dev/null +++ b/docs/weave.md @@ -0,0 +1,42 @@ +Weave +======= + +Weave 2.0.1 is supported by kubespray +Weave be use with [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode + + +In kubespray, Weave encryption for all communication is supported +* For use Weave encryption, it's necessary to specify password +if no password specify, no encrytion +``` +# In file ./inventory/group_vars/k8s-cluster.yml +weave_password: EnterPasswordHere +``` + +Weave is deploy by kubernetes with daemonSet +* Check the status of Weave containers +``` +kubectl -n kube-system get pods | grep weave +``` +* Check status of weave (connection,encryption ...) +``` +curl http://127.0.0.1:6784/status +``` + +### Consensus mode (default mode) +This mode is to fixed cluster + +### Seed mode +This mode is to dynamic cluster +* Change censensus mode to seed mode +``` +# In file ./inventory/group_vars/k8s-cluster.yml +weave_mode_seed: true +``` +the seed mode allows multi clouds simultaneously and also hybrid on premise/cloud clusters + +``` +# In file ./inventory/group_vars/k8s-cluster.yml +weave_seed: uninitialized +weave_peers: uninitialized +``` \ No newline at end of file From 2c21672de68f3e0192bf3b621b052ea737fe9c63 Mon Sep 17 00:00:00 2001 From: email Date: Thu, 27 Jul 2017 15:10:08 +0200 Subject: [PATCH 02/13] update docs --- docs/weave.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/weave.md b/docs/weave.md index 3c32d4d3a..2e1e89e5f 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -2,8 +2,8 @@ Weave ======= Weave 2.0.1 is supported by kubespray -Weave be use with [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode +Weave be use with [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode In kubespray, Weave encryption for all communication is supported * For use Weave encryption, it's necessary to specify password From 74403f2003ff756cf3a057027f00301f5c67e1ea Mon Sep 17 00:00:00 2001 From: email Date: Thu, 27 Jul 2017 17:00:54 +0200 Subject: [PATCH 03/13] update docs --- docs/weave.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index 2e1e89e5f..f5c2a23c9 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -28,15 +28,23 @@ This mode is to fixed cluster ### Seed mode This mode is to dynamic cluster + +the seed mode allows multi clouds simultaneously and also hybrid on premise/cloud clusters * Change censensus mode to seed mode ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_mode_seed: true ``` -the seed mode allows multi clouds simultaneously and also hybrid on premise/cloud clusters - +This two variables are use to have automaticaly dynamic cluster (**/!\ do not manually change these values**) ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_seed: uninitialized weave_peers: uninitialized -``` \ No newline at end of file +``` +The first variable, `weave_seed`, allows to save the first or firsts node of the weave network + +The seconde variable, `weave_peers`, allows to save IP of all node of the weave network + +these two allows to connecte a new node to the weave network. this new node need to know the first node (seed) and list of IP to all node of network + +For reset these variables set there values to `uninitialized` \ No newline at end of file From 87cdb81fae60d155d3af1d8e345bae087b4794bf Mon Sep 17 00:00:00 2001 From: email Date: Fri, 28 Jul 2017 11:33:13 +0200 Subject: [PATCH 04/13] update docs --- docs/weave.md | 35 +++++++++++++++++++++++++++++------ 1 file changed, 29 insertions(+), 6 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index f5c2a23c9..28e4c996d 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -6,45 +6,68 @@ Weave 2.0.1 is supported by kubespray Weave be use with [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode In kubespray, Weave encryption for all communication is supported -* For use Weave encryption, it's necessary to specify password -if no password specify, no encrytion + +* For use Weave encryption, it's necessary to specify password (if no password specify, no encrytion) + ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_password: EnterPasswordHere ``` +This password is use in environment variable in weave container. So it's impossible to see it somewhere + Weave is deploy by kubernetes with daemonSet + * Check the status of Weave containers + ``` +# On k8s master kubectl -n kube-system get pods | grep weave ``` + * Check status of weave (connection,encryption ...) + ``` +# On node curl http://127.0.0.1:6784/status ``` +* Check parameters of weave + +``` +# On node +ps -aux | grep weaver +``` + ### Consensus mode (default mode) + This mode is to fixed cluster ### Seed mode + This mode is to dynamic cluster the seed mode allows multi clouds simultaneously and also hybrid on premise/cloud clusters -* Change censensus mode to seed mode + +* Change consensus mode to seed mode + ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_mode_seed: true ``` + This two variables are use to have automaticaly dynamic cluster (**/!\ do not manually change these values**) + ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_seed: uninitialized weave_peers: uninitialized ``` -The first variable, `weave_seed`, allows to save the first or firsts node of the weave network -The seconde variable, `weave_peers`, allows to save IP of all node of the weave network +The first variable, `weave_seed`, allows to save the first or firsts nodes of the weave network -these two allows to connecte a new node to the weave network. this new node need to know the first node (seed) and list of IP to all node of network +The seconde variable, `weave_peers`, allows to save IP of all nodes of the weave network + +these two variables allows to connecte a new node to the weave network. this new node need to know the first node (seed) and list of IP to all node of network For reset these variables set there values to `uninitialized` \ No newline at end of file From 01af45d14ab92c0f64e548670155218fa58f9699 Mon Sep 17 00:00:00 2001 From: email Date: Mon, 31 Jul 2017 13:23:01 +0200 Subject: [PATCH 05/13] update docs --- docs/weave.md | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index 28e4c996d..2332e5b60 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -3,60 +3,60 @@ Weave Weave 2.0.1 is supported by kubespray -Weave be use with [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode +Weave uses [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode. -In kubespray, Weave encryption for all communication is supported +Weave encryption is supported for all communication -* For use Weave encryption, it's necessary to specify password (if no password specify, no encrytion) +* To use Weave encryption, specify a strong password (if no password, no encrytion) ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_password: EnterPasswordHere ``` -This password is use in environment variable in weave container. So it's impossible to see it somewhere +This password is used to set an environment variable inside weave container. -Weave is deploy by kubernetes with daemonSet +Weave is deployed by kubespray using daemonSet * Check the status of Weave containers ``` -# On k8s master +# From client kubectl -n kube-system get pods | grep weave ``` -* Check status of weave (connection,encryption ...) +* Check status of weave (connection,encryption ...) for each node ``` -# On node +# On nodes curl http://127.0.0.1:6784/status ``` -* Check parameters of weave +* Check parameters of weave for each node ``` -# On node +# On nodes ps -aux | grep weaver ``` ### Consensus mode (default mode) -This mode is to fixed cluster +This mode is best to use on static size cluster ### Seed mode -This mode is to dynamic cluster +This mode is best to use on dynamic size cluster -the seed mode allows multi clouds simultaneously and also hybrid on premise/cloud clusters +The seed mode also allows multi-clouds and hybrid on-premise/cloud clusters deployement. -* Change consensus mode to seed mode +* Switch from consensus mode to seed mode ``` # In file ./inventory/group_vars/k8s-cluster.yml weave_mode_seed: true ``` -This two variables are use to have automaticaly dynamic cluster (**/!\ do not manually change these values**) +These two variables are only used when `weave_mode_seed` is set to `true` (**/!\ do not manually change these values**) ``` # In file ./inventory/group_vars/k8s-cluster.yml @@ -64,10 +64,10 @@ weave_seed: uninitialized weave_peers: uninitialized ``` -The first variable, `weave_seed`, allows to save the first or firsts nodes of the weave network +The first variable, `weave_seed`, saves the firsts nodes of the weave network -The seconde variable, `weave_peers`, allows to save IP of all nodes of the weave network +The seconde variable, `weave_peers`, saves IP of all nodes of the weave network -these two variables allows to connecte a new node to the weave network. this new node need to know the first node (seed) and list of IP to all node of network +These two variables are used to connect a new node to the weave network. The new node needs to know the firsts nodes (seed) and the list of IPs of all nodes. -For reset these variables set there values to `uninitialized` \ No newline at end of file +To reset these variables and reset the weave network set them to `uninitialized` \ No newline at end of file From 5de7896ffbaec16ada66409dd1d287b43675c690 Mon Sep 17 00:00:00 2001 From: email Date: Mon, 31 Jul 2017 13:28:47 +0200 Subject: [PATCH 06/13] update docs --- docs/weave.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/weave.md b/docs/weave.md index 2332e5b60..9553d9642 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -5,6 +5,8 @@ Weave 2.0.1 is supported by kubespray Weave uses [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode. +`Consensus` mode is best to use on static size cluster and `seed` mode is best to use on dynamic size cluster + Weave encryption is supported for all communication * To use Weave encryption, specify a strong password (if no password, no encrytion) From dc5b955930636bee6ba3e3a4097e9527dc067d41 Mon Sep 17 00:00:00 2001 From: email Date: Mon, 31 Jul 2017 13:45:43 +0200 Subject: [PATCH 07/13] update docs --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3bc7c311c..a99132d3a 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ Versions of supported components -------------------------------- -[kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.6.4
+[kubernetes](https://github.com/kubernetes/kubernetes/releases) v1.6.7
[etcd](https://github.com/coreos/etcd/releases) v3.0.17
[flanneld](https://github.com/coreos/flannel/releases) v0.6.2
[calicoctl](https://github.com/projectcalico/calico-docker/releases) v0.23.0
From c8bcca084558c77a2d57858d2352a39609f67325 Mon Sep 17 00:00:00 2001 From: email Date: Mon, 31 Jul 2017 16:33:00 +0200 Subject: [PATCH 08/13] update docs --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a99132d3a..9569e1e0d 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,7 @@ You can choose between 4 network plugins. (default: `calico`) * [**canal**](https://github.com/projectcalico/canal): a composition of calico and flannel plugins. -* [**weave**](https://github.com/weaveworks/weave): Weave is a lightweight container overlay network that doesn't require an external K/V database cluster.
+* [**weave**](docs/weave.md): Weave is a lightweight container overlay network that doesn't require an external K/V database cluster.
(Please refer to `weave` [troubleshooting documentation](http://docs.weave.works/weave/latest_release/troubleshooting.html)). The choice is defined with the variable `kube_network_plugin`. There is also an From a276dc47e0d6fa0c455b1b0af8e7e91df6a9fb6b Mon Sep 17 00:00:00 2001 From: email Date: Tue, 1 Aug 2017 10:52:21 +0200 Subject: [PATCH 09/13] update docs --- docs/weave.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/weave.md b/docs/weave.md index 9553d9642..73e81adb2 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -25,13 +25,34 @@ Weave is deployed by kubespray using daemonSet ``` # From client kubectl -n kube-system get pods | grep weave +# output +weave-net-50wd2 2/2 Running 0 2m +weave-net-js9rb 2/2 Running 0 2m ``` +There must be as many as nodes (here kubernetes have 2 nodes so there are 2 pods weave). * Check status of weave (connection,encryption ...) for each node ``` # On nodes curl http://127.0.0.1:6784/status +# output on node1 +Version: 2.0.1 (up to date; next check at 2017/08/01 13:51:34) + + Service: router + Protocol: weave 1..2 + Name: fa:16:3e:b3:d6:b2(node1) + Encryption: enabled + PeerDiscovery: enabled + Targets: 2 + Connections: 2 (1 established, 1 failed) + Peers: 2 (with 2 established connections) + TrustedSubnets: none + + Service: ipam + Status: ready + Range: 10.233.64.0/18 + DefaultSubnet: 10.233.64.0/18 ``` * Check parameters of weave for each node @@ -39,6 +60,8 @@ curl http://127.0.0.1:6784/status ``` # On nodes ps -aux | grep weaver +# output on node1 (here its use seed mode) +root 8559 0.2 3.0 365280 62700 ? Sl 08:25 0:00 /home/weave/weaver --name=fa:16:3e:b3:d6:b2 --port=6783 --datapath=datapath --host-root=/host --http-addr=127.0.0.1:6784 --status-addr=0.0.0.0:6782 --docker-api= --no-dns --db-prefix=/weavedb/weave-net --ipalloc-range=10.233.64.0/18 --nickname=node1 --ipalloc-init seed=fa:16:3e:b3:d6:b2,fa:16:3e:f0:50:53 --conn-limit=30 --expect-npc 192.168.208.28 192.168.208.19 ``` ### Consensus mode (default mode) From 24706c163a57769a53b9c039a1f984180184120f Mon Sep 17 00:00:00 2001 From: email Date: Tue, 1 Aug 2017 14:12:21 +0200 Subject: [PATCH 10/13] update docs --- docs/weave.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index 73e81adb2..22c0c4aba 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -18,7 +18,7 @@ weave_password: EnterPasswordHere This password is used to set an environment variable inside weave container. -Weave is deployed by kubespray using daemonSet +Weave is deployed by kubespray using a daemonSet * Check the status of Weave containers @@ -29,7 +29,7 @@ kubectl -n kube-system get pods | grep weave weave-net-50wd2 2/2 Running 0 2m weave-net-js9rb 2/2 Running 0 2m ``` -There must be as many as nodes (here kubernetes have 2 nodes so there are 2 pods weave). +There must be as many pods as nodes (here kubernetes have 2 nodes so there are 2 pods weave). * Check status of weave (connection,encryption ...) for each node From c7731a3b93f7d74185422c651d5313bf9aa8e55d Mon Sep 17 00:00:00 2001 From: email Date: Tue, 1 Aug 2017 14:24:19 +0200 Subject: [PATCH 11/13] update docs --- docs/weave.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/weave.md b/docs/weave.md index 22c0c4aba..065a5a008 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -29,7 +29,7 @@ kubectl -n kube-system get pods | grep weave weave-net-50wd2 2/2 Running 0 2m weave-net-js9rb 2/2 Running 0 2m ``` -There must be as many pods as nodes (here kubernetes have 2 nodes so there are 2 pods weave). +There must be as many pods as nodes (here kubernetes have 2 nodes so there are 2 weave pods). * Check status of weave (connection,encryption ...) for each node From 9369c6549afdffa1487679823342920a3309acd1 Mon Sep 17 00:00:00 2001 From: timtoum Date: Tue, 1 Aug 2017 14:30:12 +0200 Subject: [PATCH 12/13] update docs --- docs/weave.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index 065a5a008..d5a4e351d 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -3,7 +3,7 @@ Weave Weave 2.0.1 is supported by kubespray -Weave uses [**consensus**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#initialization) mode. +Weave uses [**consensus**](https://www.weave.works/docs/net/latest/ipam/##consensus) mode (default mode) and [**seed**](https://www.weave.works/docs/net/latest/ipam/#seed) mode. `Consensus` mode is best to use on static size cluster and `seed` mode is best to use on dynamic size cluster @@ -95,4 +95,4 @@ The seconde variable, `weave_peers`, saves IP of all nodes of the weave network These two variables are used to connect a new node to the weave network. The new node needs to know the firsts nodes (seed) and the list of IPs of all nodes. -To reset these variables and reset the weave network set them to `uninitialized` \ No newline at end of file +To reset these variables and reset the weave network set them to `uninitialized` From b1a5bb593cd9afd55f191841d3136c53ade3eab4 Mon Sep 17 00:00:00 2001 From: timtoum Date: Tue, 1 Aug 2017 15:55:38 +0200 Subject: [PATCH 13/13] update docs --- docs/weave.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/weave.md b/docs/weave.md index d5a4e351d..7ac69609c 100644 --- a/docs/weave.md +++ b/docs/weave.md @@ -89,9 +89,9 @@ weave_seed: uninitialized weave_peers: uninitialized ``` -The first variable, `weave_seed`, saves the firsts nodes of the weave network +The first variable, `weave_seed`, contains the initial nodes of the weave network -The seconde variable, `weave_peers`, saves IP of all nodes of the weave network +The seconde variable, `weave_peers`, saves the IPs of all nodes joined to the weave network These two variables are used to connect a new node to the weave network. The new node needs to know the firsts nodes (seed) and the list of IPs of all nodes.