The acronym k8s for kubernetes concept represented by wooden letter tiles
Image: lexiconimages/Adobe Stock

Getting a Kubernetes cluster up and running can be a real challenge. This has been made even more apparent after the developers dropped support for the Docker runtime engine. Because of that, you might find the need to spin up a quick development cluster and don’t want to jump through all the new hoops to make it so.

Fortunately, there’s microk8s, which makes it very easy to create a small Kubernetes cluster with just a few quick commands.

SEE: Hiring kit: Back-end Developer (TechRepublic Premium)

I’m going to show you just how easy it is to do this very thing. It should take you less than five minutes to get this cluster up and running.

What is microk8s?

Microk8s was developed by Canonical to serve as a CNCF-certified upstream Kubernetes deployment tool that makes it very simple to deploy a single node or multi-node cluster. One thing to keep in mind, however, is that microk8s is not a replacement for a full-blown Kubernetes cluster. Instead, this tool should be considered specifically for development purposes and not for production deployments.

Microk8s makes it very easy to start working with Kubernetes development and can be quickly installed via snap.

What you’ll need

The only things you’ll need to get this up and running are two Linux machines that support Snap packages (such as Ubuntu) and a user with sudo privileges. I’ll be demonstrating with two virtual machine instances of Ubuntu Server 22.04.

Let’s get to the Kubernetes magic.

How to set your hostnames

Before we install microk8s, let’s set our hostnames. We’ll set the controller to microk8s1 and the node to microk8s2. To do this, log into your controller and issue the command:

sudo hostnamectl set-hostname microk8s1

Log out and log back in.

Do the same thing on the node, changing the name to microk8s2.

Next, you’ll need to add entries for each in the hosts file. Open that file on the controller with the command:

sudo nano /etc/hosts

In that file, you’ll add two entries that look like this — making sure to edit the entries to suit your IP address scheme and domains: microk8s.monkeypantz.lan microk8s1 microk8s.monkeypantz.lan microk8s2

Do the same thing on the node.

How to install microk8s

The first thing we must do is install microk8s on both machines. Log into your first machine and install the software with the command:

sudo snap install microk8s --classic

Once the installation completes, you’ll need to add your user to the microk8s group with the command:

sudo usermod -aG microk8s $USER

Next, create a .kube directory with:

mkdir ~/.kube

Give the new directory the necessary permissions with:

sudo chown -f -R $USER ~/.kube

Log out and log back in.

You can then test the install with the command:

microk8s status

You should see in the output something like this:

microk8s is running
high-availability: no
datastore master nodes:
datastore standby nodes: none

Do the same thing with the second machine.

How to join the nodes

On the machine that will serve as your controller, issue the command:

microk8s add-node

The output of the above command should include the join command that looks like this:

microk8s join

Run the join command on your second node. Once the command completes, you can verify the connection on the original node with the command:

microk8s kubectl get nodes

The output of the command should show both nodes are a part of the cluster with output that looks like this:

microk8s1   Ready <none>   9m46s   v1.24.3-2+63243a96d1c393
microk8s2   Ready <none>   15s v1.24.3-2+63243a96d1c393

One thing to keep in mind is if you need High Availability added to your Kubernetes cluster, you’ll need to have a minimum of three nodes joined together in the cluster. With three nodes, HA will be automatically enabled. You can also join nodes as workers, which can host workloads but do not run the Kubernetes control plan or add to the HA of the cluster. To join a node as a worker, you’d add the –worker flag at the end of the join command like so:

microk8s join --worker

And that’s it. You now have a two-node Kubernetes development cluster deployed in under five minutes. This is a great way to get started with container development, as you won’t have to go through the arduous steps of deploying a full-blown Kubernetes cluster.

Subscribe to TechRepublic’s How To Make Tech Work on YouTube for all the latest tech advice for business pros from Jack Wallen.

Expand your knowledge of Kubernetes with these resources from TechRepublic Academy.

Subscribe to the Developer Insider Newsletter

From the hottest programming languages to commentary on the Linux OS, get the developer and open source news and tips you need to know. Delivered Tuesdays and Thursdays

Subscribe to the Developer Insider Newsletter

From the hottest programming languages to commentary on the Linux OS, get the developer and open source news and tips you need to know. Delivered Tuesdays and Thursdays