c12s-kubespray/docs/weave.md

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.

`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)

```
# In file ./inventory/group_vars/k8s-cluster.yml
weave_password: EnterPasswordHere
```

This password is used to set an environment variable inside weave container.

Weave is deployed by kubespray using daemonSet

* Check the status of Weave containers

```
# From client
kubectl -n kube-system get pods | grep weave
```

* Check status of weave (connection,encryption ...) for each node

```
# On nodes
curl http://127.0.0.1:6784/status
```

* Check parameters of weave for each node

```
# On nodes
ps -aux | grep weaver
```

### Consensus mode (default mode)

This mode is best to use on static size cluster

### Seed mode

This mode is best to use on dynamic size cluster

The seed mode also allows multi-clouds and hybrid on-premise/cloud clusters deployement.

* Switch from consensus mode to seed mode

```
# In file ./inventory/group_vars/k8s-cluster.yml
weave_mode_seed: true
```

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
weave_seed: uninitialized
weave_peers: uninitialized
```

The first variable, `weave_seed`, saves the firsts nodes of the weave network

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`
new doc for weave 2017-07-27 12:40:52 +00:00			`Weave`
			`=======`

			`Weave 2.0.1 is supported by kubespray`

update docs 2017-07-31 11:23:01 +00:00			`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.`
new doc for weave 2017-07-27 12:40:52 +00:00
update docs 2017-07-31 11:28:47 +00:00			`Consensus` mode is best to use on static size cluster and `seed` mode is best to use on dynamic size cluster

update docs 2017-07-31 11:23:01 +00:00			`Weave encryption is supported for all communication`
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`* To use Weave encryption, specify a strong password (if no password, no encrytion)`
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			```
			`# In file ./inventory/group_vars/k8s-cluster.yml`
			`weave_password: EnterPasswordHere`
			```

update docs 2017-07-31 11:23:01 +00:00			`This password is used to set an environment variable inside weave container.`
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`Weave is deployed by kubespray using daemonSet`
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			`* Check the status of Weave containers`
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			```
update docs 2017-07-31 11:23:01 +00:00			`# From client`
new doc for weave 2017-07-27 12:40:52 +00:00			`kubectl -n kube-system get pods \| grep weave`
			```
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`* Check status of weave (connection,encryption ...) for each node`
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			```
update docs 2017-07-31 11:23:01 +00:00			`# On nodes`
new doc for weave 2017-07-27 12:40:52 +00:00			`curl http://127.0.0.1:6784/status`
			```

update docs 2017-07-31 11:23:01 +00:00			`* Check parameters of weave for each node`
update docs 2017-07-28 09:33:13 +00:00
			```
update docs 2017-07-31 11:23:01 +00:00			`# On nodes`
update docs 2017-07-28 09:33:13 +00:00			`ps -aux \| grep weaver`
			```

new doc for weave 2017-07-27 12:40:52 +00:00			`### Consensus mode (default mode)`
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`This mode is best to use on static size cluster`
new doc for weave 2017-07-27 12:40:52 +00:00
			`### Seed mode`
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`This mode is best to use on dynamic size cluster`
update docs 2017-07-27 15:00:54 +00:00
update docs 2017-07-31 11:23:01 +00:00			`The seed mode also allows multi-clouds and hybrid on-premise/cloud clusters deployement.`
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			`* Switch from consensus mode to seed mode`
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			```
			`# In file ./inventory/group_vars/k8s-cluster.yml`
			`weave_mode_seed: true`
			```
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			These two variables are only used when `weave_mode_seed` is set to `true` (/!\ do not manually change these values)
update docs 2017-07-28 09:33:13 +00:00
new doc for weave 2017-07-27 12:40:52 +00:00			```
			`# In file ./inventory/group_vars/k8s-cluster.yml`
			`weave_seed: uninitialized`
			`weave_peers: uninitialized`
update docs 2017-07-27 15:00:54 +00:00			```

update docs 2017-07-31 11:23:01 +00:00			The first variable, `weave_seed`, saves the firsts nodes of the weave network
update docs 2017-07-28 09:33:13 +00:00
update docs 2017-07-31 11:23:01 +00:00			The seconde variable, `weave_peers`, saves IP of all nodes of the weave network
update docs 2017-07-27 15:00:54 +00:00
update docs 2017-07-31 11:23:01 +00:00			`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.`
update docs 2017-07-27 15:00:54 +00:00
update docs 2017-07-31 11:23:01 +00:00			To reset these variables and reset the weave network set them to `uninitialized`