Setting Up a Lightweight Kubernetes Cluster with K3s

Quick Navigation

Difficulty: Beginner
Estimated Time: 10-20 minutes
Prerequisites: Linux environment, sudo privileges, basic command-line knowledge, internet connection

Introduction

In recent years, Kubernetes has become the go-to choice for orchestrating containerized applications. However, for developers and tech enthusiasts looking to run Kubernetes on resource-constrained devices, K3s, a lightweight Kubernetes distribution, is the perfect solution! Designed by Rancher Labs, K3s provides a streamlined Kubernetes experience, making it ideal for IoT devices, small servers, and edge computing. In this article, we'll guide you through the installation and configuration of K3s on a Linux environment, allowing you to quickly and easily set up your own Kubernetes cluster.

Step-by-Step Guide to Installing K3s

To get started with K3s, you'll first need to ensure that Docker is installed on your system. Docker provides the container runtime required by K3s to manage pods and containers.

1. Install Docker

Run the following command to install Docker:

sudo apt-get install docker

Tip: Make sure to have sudo privileges to install Docker on your system.

2. Install K3s

K3s can be installed in just a single step with the following command:

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

This script will download and install K3s, including all necessary components. Once completed, K3s will automatically start and set itself up as a service on your system.

3. Configure kubectl for K3s

By default, K3s places its kubeconfig file in /etc/rancher/k3s/k3s.yaml. To use kubectl with this configuration, you'll need to copy this file to your home directory and adjust the permissions:

mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown $(whoami):$(whoami) ~/.kube/config

These commands create a .kube directory in your home folder, copy the K3s configuration file to it, and change ownership to your current user, allowing you to access and modify the configuration file as needed.

4. Verify the K3s Cluster

After setting up K3s, you can check the status of your cluster by listing the nodes with the following command:

kubectl get nodes

This command should return a list of nodes, indicating that your K3s cluster is up and running.

Conclusion

With K3s, you now have a fully functioning Kubernetes cluster that's lightweight and easy to manage. Whether you're running on a small virtual machine or an edge device, K3s provides the essential capabilities of Kubernetes without the extra overhead. By following the steps outlined in this guide, you can now leverage Kubernetes in environments where traditional distributions might be too resource-intensive. Happy clustering!