K3s

Specification

Control PlaneCNIDefault OSInstalls ClusterClassIPv4IPv6
k3sCiliumUbuntu 22.04NoYesNo

Prerequisites

  • Quickstart completed
  • Select a k3s kubernetes version to set for the kubernetes version
  • Installed k3s bootstrap provider into your management cluster
    • Add the following to ~/.cluster-api/clusterctl.yaml for the k3s bootstrap/control plane providers
      providers:
        - name: "k3s"
          url: https://github.com/k3s-io/cluster-api-k3s/releases/latest/bootstrap-components.yaml
          type: "BootstrapProvider"
        - name: "k3s"
          url: https://github.com/k3s-io/cluster-api-k3s/releases/latest/control-plane-components.yaml
          type: "ControlPlaneProvider"
          
      
    • Install the k3s provider into your management cluster
      clusterctl init --bootstrap k3s --control-plane k3s
      

Usage

  1. Generate cluster yaml
    clusterctl generate cluster test-cluster \
        --kubernetes-version v1.29.1+k3s2 \
        --infrastructure linode-linode \
        --flavor k3s > test-k3s-cluster.yaml
    
  2. Apply cluster yaml
    kubectl apply -f test-k3s-cluster.yaml