Overview
This section documents addons for self-managed clusters.
Currently, all addons are installed via Cluster API Addon Provider Helm (CAAPH).
CAAPH is installed by default in the KIND cluster created by make tilt-cluster.
For more information, please refer to the CAAPH Quick Start.
The Linode Cloud Controller Manager and
Linode CSI Driver addons require the ClusterResourceSet feature flag
to be set on the management cluster.
This feature flag is enabled by default in the KIND cluster created by make tilt-cluster.
For more information, please refer to the ClusterResourceSet page in The Cluster API Book.
Contents
CNI
In order for pod networking to work properly, a Container Network Interface (CNI) must be installed.
Cilium
Installed by default
To install Cilium on a self-managed cluster, simply apply the cni: <cluster-name>-cilium
label on the Cluster resource if not already present.
kubectl label cluster $CLUSTER_NAME cni=$CLUSTER_NAME-cilium --overwrite
Cilium will then be automatically installed via CAAPH into the labeled cluster.
Enabled Features
By default, Cilium's BGP Control Plane is enabled when using Cilium as the CNI.
CCM
In order for the InternalIP and ExternalIP of the provisioned Nodes to be set correctly,
a Cloud Controller Manager (CCM) must be installed.
Linode Cloud Controller Manager
Installed by default
To install the linode-cloud-controller-manager (linode-ccm)
on a self-managed cluster, simply apply the ccm: <cluster-name>-linode
label on the Cluster resource if not already present.
kubectl label cluster $CLUSTER_NAME ccm=$CLUSTER_NAME-linode --overwrite
The linode-ccm will then be automatically installed via CAAPH into the labeled cluster.
Container Storage
In order for stateful workloads to create PersistentVolumes (PVs), a storage driver must be installed.
Linode CSI Driver
Installed by default
To install the csi-driver-linode
on a self-managed cluster, simply apply the csi: <cluster-name>-linode
label on the Cluster resource if not already present.
kubectl label cluster $CLUSTER_NAME csi=$CLUSTER_NAME-linode --overwrite
The csi-driver-linode will then be automatically installed via CAAPH into the labeled cluster.