Kube-Vip as a daemonset


Other Kubernetes distributions can bring up a Kubernetes cluster, without depending on a VIP (BUT they are configured to support one). A prime example of this would be k3s, that can be configured to start and also sign the certificates to allow incoming traffic to a virtual IP. Given we don't need the VIP to exist before the cluster, we can bring up the k3s node(s) and then add kube-vip as a daemonset for all control plane nodes.

If the Kubernetes installer allows for adding a Virtual IP as an additional SAN to the API server certificate then we can apply kube-vip to the cluster once the first node has been brought up.

Kube-Vip as HA, Load-Balancer or both ¯\_(ツ)_/¯

When generating a manifest for kube-vip we will pass in the flags --controlplane / --services these will enable the various types of functionality within kube-vip.

With both enabled kube-vip will manage a virtual IP address that is passed through it's configuration for a Highly Available Kubernetes cluster, it will also "watch" services of type:LoadBalancer and once their spec.LoadBalancerIP is updated (typically by a cloud controller) it will advertise this address using BGP/ARP.

Note about Daemonsets

Unlike generating the static manifest there are a few more things that may need configuring, this page will cover most scenarios.

Create the RBAC settings

As a daemonSet runs within the Kubernetes cluster it needs the correct access to be able to watch Kubernetes services and other objects. In order to do this we create a User, Role, and a binding.. we can apply this with the command:

kubectl apply -f https://kube-vip.io/manifests/rbac.yaml

Generating a Manifest

This section only covers generating a simple BGP configuration, as the main focus is will be on additional changes to the manifest. For more examples we can look at here.

Note: Pay attention if using the "static" examples, as the manifest subcommand should use daemonset and NOT pod.

Set configuration details

export VIP=

export INTERFACE=<interface>

Configure to use a container runtime

The easiest method to generate a manifest is using the container itself, below will create an alias for different container runtimes.


alias kube-vip="ctr run --rm --net-host docker.io/plndr/kube-vip:0.3.1 vip"


alias kube-vip="docker run --network host --rm plndr/kube-vip:0.3.1"

BGP Example

This configuration will create a manifest that will start kube-vip providing controlplane and services management. Unlike ARP, all nodes in the BGP configuration will advertise virtual IP addresses.

Note we bind the address to lo as we don't want multiple devices that have the same address on public interfaces. We can specify all the peers in a comma seperate list in the format of address:AS:password:multihop.

Note 2 we pass the --inCluster flag as this is running as a daemonSet within the Kubernetes cluster and therefore will have access to the token inside the running pod.

Note 2 we pass the --taint flag as we're deploying kube-vip as both a daemonset and as advertising controlplane, we want to taint this daemonset to only run on the worker nodes.

export INTERFACE=lo

kube-vip manifest daemonset \
    --interface $INTERFACE \
    --vip $VIP \
    --controlplane \
    --services \
    --inCluster \
    --taint \
    --bgp \

Generated Manifest

apiVersion: apps/v1
kind: DaemonSet
  creationTimestamp: null
  name: kube-vip-ds
  namespace: kube-system
      name: kube-vip-ds
      creationTimestamp: null
        name: kube-vip-ds
      - args:
        - manager
        - name: vip_arp
          value: "false"
        - name: vip_interface
          value: lo
        - name: port
          value: "6443"
        - name: vip_cidr
          value: "32"
        - name: cp_enable
          value: "true"
        - name: cp_namespace
          value: kube-system
        - name: vip_ddns
          value: "false"
        - name: svc_enable
          value: "true"
        - name: bgp_enable
          value: "true"
        - name: bgp_routerid
        - name: bgp_as
          value: "65000"
        - name: bgp_peeraddress
        - name: bgp_peerpass
        - name: bgp_peeras
          value: "65000"
        - name: bgp_peers
        - name: vip_address
        image: 'plndr/kube-vip:'
        imagePullPolicy: Always
        name: kube-vip
        resources: {}
            - NET_ADMIN
            - NET_RAW
            - SYS_TIME
      hostNetwork: true
        node-role.kubernetes.io/master: "true"
      serviceAccountName: kube-vip
      - effect: NoSchedule
        key: node-role.kubernetes.io/master
        operator: Exists
  updateStrategy: {}
  currentNumberScheduled: 0
  desiredNumberScheduled: 0
  numberMisscheduled: 0
  numberReady: 0

Managing a routerID as a daemonset

The routerID needs to be unique on each node that participates in BGP advertisements. In order to do this we can modify the manifest so that when kube-vip starts it will look up its local address and use that as the routerID.

          - name: bgp_routerinterface
            value: "ens160"

This will instruct each instance of kube-vip as part of the daemonset to look up the IP address on that interface and use it as the routerID.

Manifest Overview