From 5cd8bb5d98bee4768ba70fbbd0bec72c89290db6 Mon Sep 17 00:00:00 2001 From: "Felix Wischke (65278)" Date: Wed, 10 Apr 2024 21:08:48 +0200 Subject: [PATCH] docs: document ipv6 only cluster kube-vip version --- docs/Troubleshooting.md | 13 +++++++++++++ docs/advanced-setups.md | 9 +++++++++ 2 files changed, 22 insertions(+) diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index ae4aa109..7857395f 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -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]" +``` diff --git a/docs/advanced-setups.md b/docs/advanced-setups.md index f58f1c21..5d3d0055 100644 --- a/docs/advanced-setups.md +++ b/docs/advanced-setups.md @@ -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