Making dual stack ipv6 work with k3s
2021-07-27 - How to setup a working ipv4/ipv6 service on k3s
Tags: ipv6 k3s kubernetes
Introduction
I have yet to write a lot about the kubernetes setup I use for pieces of my personal infrastructure, because I was not satisfied with what I had to show. Today I picked up k3s again which I like quite a lot for it being a light implementation. Consuming 800M of ram before you get any workload running is hardly lightweight, but it is the lightest I have experienced for kubernetes. An entry level virtual machine at ovh or hetzner having 2G of ram for 3€/month is sufficient to run it, that’s what I have been doing for the last year.
The main thing I was not satisfied was ipv6 support. I do not know what changed since last year when I tried and failed to make it work in k3s 1.19, but now with 1.21 and some effort it does work! Here is how.
Installation
Let’s start with a freshly reinstalled ovh vps with Ubuntu 20.04. Make sure to properly configure ipv6 on it, for this ovh machine I configured a netplan that looks like this :
network:
version: 2
ethernets:
ens3:
dhcp4: true
match:
macaddress: fa:16:3e:82:71:b7
mtu: 1500
set-name: ens3
dhcp6: no
addresses:
- 2001:41d0:401:3100:0:0:0:fd5/128
gateway6: 2001:41d0:0401:3100:0000:0000:0000:0001
routes:
- to: 2001:41d0:0401:3100:0000:0000:0000:0001
scope: link
After installation I just ran an apt dist-upgrade
then installed ipvsadm
. Afterwards it’s all k3s :
export INSTALL_K3S_VERSION=v1.21.3+k3s1
export INSTALL_K3S_EXEC="server --disable traefik --disable servicelb --disable metrics-server --disable-cloud-controller \
--kube-proxy-arg proxy-mode=ipvs --cluster-cidr=10.42.0.0/16,fd42::/48 --service-cidr=10.43.0.0/16,fd43::/112 \
--disable-network-policy --flannel-backend=none --node-ip=37.187.244.19,2001:41d0:401:3100::fd5"
As you can see we need to disable quite a few k3s components, mainly flannel which does not support dual stack at all at this time (it has been coming soon© to flannel for quite some time) and servicelb (the internal component to k3s which allows to simply use the LoadBalancer service type). We are going to use Calico instead of flannel therefore we also disable k3s’ internal network policy system, and we are going to need to customize the ingress service so we also disable the integrated traefik. We will use metallb instead of servicelb and ingress-nginx instead of traefik.
If you are replicating this on your own setup make sure the node-ip addresses are the ones configured on your node, if the cluster-cidr and service-cidr do not conflict with your own you can keep those.
Once ready review the k3s installation script then run it :
wget https://get.k3s.io -O k3s.sh
less k3s.sh
bash k3s.sh
With k3s installed you should be able to access the kubernetes cli with kubectl get nodes
but basic services like coredns pod won’t start before calico is setup.
Calico
Retrieve Calico’s manifests with :
wget https://docs.projectcalico.org/manifests/calico.yaml
Edit this file and locate the ipam
section of the ConfigMap. Change it to the following :
"ipam": {
"type": "calico-ipam",
"assign_ipv4": "true",
"assign_ipv6": "true"
},
Then locate the FELIX_IPV6SUPPORT
variable in the calico-node DaemonSet configuration and set it to true
.
You can then apply this manifest :
kubectl apply -f calico.yaml
From there for standard pods and services should start properly, give calico some time and check :
kubectl get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
kube-system pod/local-path-provisioner-5ff76fc89d-5xvcg 1/1 Running 0 2m51s
kube-system pod/calico-node-dfwp5 1/1 Running 0 67s
kube-system pod/coredns-7448499f4d-ckzlk 1/1 Running 0 2m51s
kube-system pod/calico-kube-controllers-78d6f96c7b-m527n 1/1 Running 0 67s
You should have four pods running : coredns, two calico pods and k3s’ local path provisionner.
Metallb
Since this is a cheap and self made infrastructure we are going to rely on metallb to provide us with external connectivity. Install it with :
wget https://raw.githubusercontent.com/metallb/metallb/v0.10.2/manifests/namespace.yaml -O metallb-namespace.yaml
wget https://raw.githubusercontent.com/metallb/metallb/v0.10.2/manifests/metallb.yaml -O metallb-0.10.2-manifest.yaml
kubectl apply -f metallb-namespace.yaml -f metallb-0.10.2-manifest.yaml
Then create a metallb-config.yaml with content like this :
apiVersion: v1
kind: ConfigMap
metadata:
namespace: metallb-system
name: config
data:
config: |
address-pools:
- name: default
protocol: layer2
addresses:
- 37.187.244.19/32
- 2001:41d0:401:3100::fd5/128
Don’t forget to replace the ipv4 and ipv6 addresses with the ones configured on your node. Then apply this manifest :
kubectl apply -f metallb-config.yaml
Give it a minute then check that everything is ok :
kubectl -n metallb-system get pods
NAME READY STATUS RESTARTS AGE
pod/controller-6b78bff7d9-szz78 1/1 Running 0 86s
pod/speaker-mx46m 1/1 Running 0 86s
Ingress-nginx
From there we can setup our ingress-nginx, but it will require a bit of service customization :
wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v0.48.1/deploy/static/provider/baremetal/deploy.yaml \
-O ingress-nginx-0.48.1.yaml
Edit this file and locate the ingress-nginx-controller Service, which is by default of type NodePort. We are going to replace it with two services of type LoadBalancer, one for ipv4 and one for ipv6. Theoretically a single DualStack service should be supported but it does not work for me, the service only listens on its ipv6 address. So we are going to replace the whole ingress-nginx-controller Service with these two entries :
apiVersion: v1
kind: Service
metadata:
annotations:
labels:
helm.sh/chart: ingress-nginx-3.34.0
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/instance: ingress-nginx
app.kubernetes.io/version: 0.48.1
app.kubernetes.io/managed-by: Helm
app.kubernetes.io/component: controller
name: ingress-nginx-controller-v4
namespace: ingress-nginx
spec:
type: LoadBalancer
ipFamilies:
- IPv4
ports:
- name: http
port: 80
protocol: TCP
targetPort: http
- name: https
port: 443
protocol: TCP
targetPort: https
selector:
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/instance: ingress-nginx
app.kubernetes.io/component: controller
---
apiVersion: v1
kind: Service
metadata:
annotations:
labels:
helm.sh/chart: ingress-nginx-3.34.0
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/instance: ingress-nginx
app.kubernetes.io/version: 0.48.1
app.kubernetes.io/managed-by: Helm
app.kubernetes.io/component: controller
name: ingress-nginx-controller-v6
namespace: ingress-nginx
spec:
type: LoadBalancer
ipFamilies:
- IPv6
ports:
- name: http
port: 80
protocol: TCP
targetPort: http
- name: https
port: 443
protocol: TCP
targetPort: https
selector:
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/instance: ingress-nginx
app.kubernetes.io/component: controller
Note the metadata names with -v4
and -v6
suffixes, the type: LoadBalancer
and the respective ipFamilies. You can now apply this manifest :
kubectl apply -f ingress-nginx-0.48.1.yaml
Give it some time, then check that the two controller services each get the ipv4 or ipv6 address of your node :
kubectl -n ingress-nginx get pods,svc
NAME READY STATUS RESTARTS AGE
pod/ingress-nginx-admission-create-hcgdm 0/1 Completed 0 52s
pod/ingress-nginx-admission-patch-hl2vw 0/1 Completed 1 52s
pod/ingress-nginx-controller-5cb8d9c6dd-5692s 1/1 Running 0 52s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/ingress-nginx-controller-admission ClusterIP 10.43.244.41 <none> 443/TCP 37s
service/ingress-nginx-controller-v4 LoadBalancer 10.43.139.251 37.187.244.19 80:31501/TCP,443:32318/TCP 37s
service/ingress-nginx-controller-v6 LoadBalancer fd43::2a99 2001:41d0:401:3100::fd5 80:31923/TCP,443:30428/TCP 36s
Conclusion
Now you can deploy your own services, personally I am going to migrate this blog then my privatebin and miniflux instances and see if it is reliable.