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/##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

Weave encryption is supported for all communication

* To use Weave encryption, specify a strong password (if no password, no encryption)

```ShellSession
# In file ./inventory/sample/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 a daemonSet

* Check the status of Weave containers

```ShellSession
# 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 pods as nodes (here kubernetes have 2 nodes so there are 2 weave pods).

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

```ShellSession
# 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

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

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 deployment.

* Switch from consensus mode to seed/Observation mode

See [weave ipam documentation](https://www.weave.works/docs/net/latest/tasks/ipam/ipam/) and use `weave_extra_args` to enable.
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00			`# Weave`
new doc for weave 2017-07-27 12:40:52 +00:00
			`Weave 2.0.1 is supported by kubespray`

update docs 2017-08-01 12:30:12 +00:00			`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.`
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
Fix some typos Signed-off-by: Rui Cao <ruicao@alauda.io> 2018-09-19 10:22:08 +00:00			`* To use Weave encryption, specify a strong password (if no password, no encryption)`
update docs 2017-07-28 09:33:13 +00:00
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00			```ShellSession
Rename ansible groups to use _ instead of - (#7552) * rename ansible groups to use _ instead of - k8s-cluster -> k8s_cluster k8s-node -> k8s_node calico-rr -> calico_rr no-floating -> no_floating Note: kube-node,k8s-cluster groups in upgrade CI need clean-up after v2.16 is tagged * ensure old groups are mapped to the new ones 2021-04-29 12:20:50 +00:00			`# In file ./inventory/sample/group_vars/k8s_cluster.yml`
new doc for weave 2017-07-27 12:40:52 +00:00			`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-08-01 12:12:21 +00:00			`Weave is deployed by kubespray using a 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
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00			```ShellSession
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-08-01 08:52:21 +00:00			`# output`
			`weave-net-50wd2 2/2 Running 0 2m`
			`weave-net-js9rb 2/2 Running 0 2m`
new doc for weave 2017-07-27 12:40:52 +00:00			```
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00
update docs 2017-08-01 12:24:19 +00:00			`There must be as many pods as nodes (here kubernetes have 2 nodes so there are 2 weave pods).`
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
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00			```ShellSession
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-08-01 08:52:21 +00:00			`# 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`
new doc for weave 2017-07-27 12:40:52 +00:00			```

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
Add markdown CI (#5380) 2019-12-04 15:22:57 +00:00			```ShellSession
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`
update docs 2017-08-01 08:52:21 +00:00			`# 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`
update docs 2017-07-28 09:33:13 +00:00			```

Add markdown CI (#5380) 2019-12-04 15:22:57 +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
fix-up some spelling mistakes (#5202) 2019-09-26 06:27:08 +00:00			`The seed mode also allows multi-clouds and hybrid on-premise/cloud clusters deployment.`
update docs 2017-07-28 09:33:13 +00:00
Cleanup unused/erroneous variables (#6003) 2020-04-24 08:54:07 +00:00			`* Switch from consensus mode to seed/Observation mode`
update docs 2017-07-28 09:33:13 +00:00
Cleanup unused/erroneous variables (#6003) 2020-04-24 08:54:07 +00:00			See [weave ipam documentation](https://www.weave.works/docs/net/latest/tasks/ipam/ipam/) and use `weave_extra_args` to enable.