../../_images/canonical_microk8s.png

Canonical MicroK8s

MicroK8s is the simplest production-grade conformant K8s. Lightweight and focused. Single command install on Linux, Windows and macOS.

Prerequisites

The L7|ESP Helm chart can be installed onto a multi-node MicroK8s cluster running on traditional VMs:

  • A fleet of virtual machines (e.g. Ubuntu) to convert into MicroK8s nodes

Install Kubernetes

The installation steps for Ubuntu are, roughly, as follows:

$ sudo apt-get update
$ sudo apt-get upgrade -y
$ sudo snap install core
$ sudo snap install microk8s --classic --channel=1.20/stable
$ sudo microk8s status --wait-ready
$ sudo usermod -a -G microk8s l7esp
$ sudo chown -f -R l7esp ~/.kube
$ echo -e "l7esp\nl7esp" | passwd root
$ echo "alias kubectl='microk8s kubectl'" >> ~/.bash_rc

Note

Please refer to the official documentation for latest advice on how to install MicroK8s. The steps above are merely for demonstation purposes. Install a local Kubernetes with MicroK8s

Access the Kubernetes cluster

SSH into one of the cluster’s master node and check that all nodes were provisioned and are in Ready state, with the following command:

$ microk8s kubectl get nodes
NAME         STATUS   ROLES    AGE   VERSION
k8s-master   Ready    <none>   1h    v1.20.13-35+d877e7a8ac536e
k8s-node-1   Ready    <none>   1h    v1.20.13-35+d877e7a8ac536e
k8s-node-2   Ready    <none>   1h    v1.20.13-35+d877e7a8ac536e

Installing L7|ESP Helm chart

To install L7|ESP on the new Kubernetes cluster, see the Helm deployment guide.

Note

MicroK8s comes with its own packaged version of the Kubernetes CLI so remember to use the microk8s kubectl to ensure you are using the correct version when controlling the cluster.