A Kubernetes in Kubernetes tool, k3k provides a way to run multiple embedded isolated k3s clusters on your kubernetes cluster.

An example on creating a k3k cluster on an RKE2 host using k3kcli

K3K consists of a controller and a cli tool, the controller can be deployed via a helm chart and the cli can be downloaded from the releases page.

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Once Helm has been set up correctly, add the repo as follows:

  helm repo add k3k https://galal-hussein.github.io/k3k

If you had already added this repo earlier, run helm repo update to retrieve the latest versions of the packages. You can then run helm search repo k3k to see the charts.

To install the k3k chart:

helm install my-k3k k3k/k3k

To uninstall the chart:

helm delete my-k3k

To create a new cluster you need to install and run the cli or create a cluster object, to install the cli:

wget https://github.com/galal-hussein/k3k/releases/download/v0.0.0-alpha2/k3kcli
chmod +x k3kcli
sudo cp k3kcli /usr/local/bin

To create a new cluster you can use:

k3k cluster create --name example-cluster --token test