Cloud-Native

Setting Up a Kubernetes Cluster with Kubeadm: A Step-by-Step Guide

Justin VanWinkle

Justin VanWinkle

— 3 min read
Setting Up a Kubernetes Cluster with Kubeadm: A Step-by-Step Guide

In the rapidly evolving world of cloud-native technologies, Kubernetes has become the cornerstone for container orchestration. While Kubernetes simplifies the management of containerized applications, setting up and managing a Kubernetes cluster can still be intricate. That's where Kubeadm comes into play, providing a streamlined way to bootstrap a Kubernetes cluster. In this blog post, we'll guide you through the process of setting up a Kubernetes cluster using Kubeadm, share essential commands, and offer best practices based on real-world experiences.

Why Use Kubeadm?

Kubeadm simplifies the process of initializing and configuring a Kubernetes cluster. It handles the necessary steps for cluster setup, such as generating certificates, creating required resources, and configuring networking. This tool is ideal for anyone looking to get a Kubernetes cluster up and running quickly with minimal hassle.

Prerequisites

  • At least two Linux machines (one master node and one worker node) with Ubuntu 20.04 LTS or CentOS 7
  • Minimum 2GB RAM and 2 CPUs for each node
  • Root or sudo access on all machines
  • Basic understanding of Kubernetes and containerization

Step-by-Step Guide to Setting Up the Cluster

1. Install Docker

First, install Docker on all machines. Use the following commands:

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker

2. Install Kubeadm, Kubelet, and Kubectl

Next, install Kubeadm, Kubelet, and Kubectl on all nodes:

sudo apt-get update
sudo apt-get install -y apt-transport-https curl
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
cat <

3. Disable Swap

Kubernetes requires swap to be disabled. Run this command on all nodes:

sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab

4. Initialize the Master Node

Initialize the master node using Kubeadm:

sudo kubeadm init --pod-network-cidr=10.244.0.0/16

After the initialization, you will receive a kubeadm join command. Save it for later when joining the worker nodes.

Configure kubectl for the master node:

mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

5. Deploy a Pod Network

Deploy a pod network so that your pods can communicate with each other. We'll use Flannel as an example:

kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml

6. Join Worker Nodes to the Cluster

Run the kubeadm join command obtained during the master node initialization on each worker node:

sudo kubeadm join <master-node-ip>:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>

7. Verify the Cluster

On the master node, verify that all nodes have joined the cluster and are in the Ready state:

kubectl get nodes

Best Practices and Lessons Learned

1. Regular Backups

Always perform regular backups of your Kubernetes cluster, especially the /etc/kubernetes directory on the master node. This ensures you can recover from unexpected failures.

2. Secure Your Cluster

Enable Role-Based Access Control (RBAC) to secure access to your cluster. Use network policies to control communication between pods and limit exposure to external networks.

3. Monitor and Scale

Implement monitoring solutions like Prometheus and Grafana to keep an eye on cluster performance. Utilize Horizontal Pod Autoscaling and Cluster Autoscaler to handle varying workloads efficiently.

4. Maintain Up-to-Date Documentation

Document every step of your cluster setup and maintenance procedures. This ensures that your team can handle future scaling, troubleshooting, and upgrades without relying on tribal knowledge.

Conclusion

Setting up a Kubernetes cluster with Kubeadm offers a streamlined and robust method for managing containerized applications at scale. By following this guide and incorporating best practices, you can ensure a highly available and secure Kubernetes environment. Have you used Kubeadm to set up your Kubernetes cluster? Share your experiences and insights in the comments below!

Read more