Difficulty: Beginner
Estimated Time: 10 minutes

Welcome, this tutorial will show you how easy it is to setup k3s, the easy to install, lightweight Kubernetes distribution.

For more information, check out https://k3s.io and https://github.com/rancher/k3s/blob/master/README.md.

Explore k3s

Step 1 of 3

Step 1

Install k3s

The first step is installing k3s.

k3s consists of a server and an agent, where the server will run the master components, and the agent the worker components.

  • Host 1 (master) will function as server and will also join the cluster by running the agent.

There is a simple curl oneliner to install k3s. For demo purposes, we are pre-configuring a cluster secret.

curl -sfL https://get.k3s.io | K3S_CLUSTER_SECRET=thisisverysecret sh -

You can run the following command to check if the node is in Ready state (you might need to run the command a couple of times, can take up to 30 seconds for the node to register):

k3s kubectl get node

For your convenience, the following command will wait until the node shows up as Ready:

until k3s kubectl get node 2>/dev/null | grep master | grep -q ' Ready'; do sleep 1; done; k3s kubectl get node

As soon as it shows master with status Ready, you have built your single host cluster!

master   Ready    <none>   28s   v1.13.5-k3s.1
Terminal Host 2