Skip to content

Commit

Permalink
docs: document ipv6 only cluster kube-vip version
Browse files Browse the repository at this point in the history
  • Loading branch information
65278 committed Apr 10, 2024
1 parent cf7fcb5 commit 5cd8bb5
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 0 deletions.
13 changes: 13 additions & 0 deletions docs/Troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,3 +67,16 @@ If your capi-controller is too new, you can pass a `--core cluster-api:v1.6.1` d
## Calico fails in IPVS mode with loadBalancers to expose services
Calico unfortunately does not test connectivity when it choses a node ip to use for IPVS communication.
This can be altered manually. More on this topic in [Calicos documentation](https://docs.tigera.io/calico/latest/networking/ipam/ip-autodetection#autodetection-methods).

## IPv6 only cluster, kube-vip fails with "unable to detect default interface"
Older versions of `kube-vip` do not consider the IPv6 routing table and therefore IPv6 interface detection fails.
Update `kube-vip` to version `0.7.2`.

Example log:
```
time="2024-03-14T11:48:58Z" level=info msg="Starting kube-vip.io [v0.5.10]"
time="2024-03-14T11:48:58Z" level=info msg="namespace [kube-system], Mode: [ARP], Features(s): Control Plane:[true], Services:[false]"
time="2024-03-14T11:48:58Z" level=info msg="No interface is specified for VIP in config, auto-detecting default Interface"
....
time="2024-03-14T11:52:30Z" level=fatal msg="unable to detect default interface -> [Unable to find default route]"
```
9 changes: 9 additions & 0 deletions docs/advanced-setups.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,15 @@ export IPV6_PREFIX=64
export IPV6_GATEWAY="2001:db8:1::1"
```

If you're using cilium, be aware that cilium's helm chart requires `ipv6.enabled=true` to actually support IPv6 pod- and service networks.

## IPv6 only cluster

Clusters without IPv4 are possible, but require kube-vip to be newer than 0.7.1 (version 0.7.0 probably works, but we did not test it).

If you're using cilium, be aware that Cilium's helm chart requires `ipv6.enabled=true` to actually support IPv6 pod- and service networks.


#### Generate a Cluster

```bash
Expand Down

0 comments on commit 5cd8bb5

Please sign in to comment.