In this tutorial, we will walk you through the process of setting up a Kubernetes cluster on an Ubuntu system. By following these steps, you'll be able to create a robust environment where you can manage and orchestrate containerized applications seamlessly. Let's get started!

Prerequisites

Before you begin, ensure that you have a system running Ubuntu and have sudo privileges to execute administrative commands.

Step 1: Setting up the Master Node

First, we need to configure our master node by setting the hostname and disabling the swap memory. Use the following commands:

sudo hostnamectl set-hostname "k8smaster.example.net"
sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab

Step 2: Configuring Kernel Parameters

Next, we will configure the necessary kernel modules and parameters to enhance the performance and security of our cluster. Run the following commands to load the necessary modules and set the system parameters:

sudo tee /etc/modules-load.d/containerd.conf <<EOF
overlay
br_netfilter
EOF

sudo modprobe overlay
sudo modprobe br_netfilter

sudo tee /etc/sysctl.d/kubernetes.conf <<EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
EOF

sudo sysctl --system

Step 3: Installing Dependencies

Before installing Kubernetes, we need to install some prerequisite packages and add the necessary repositories to our system. Use the following commands to do this:

sudo apt install -y curl gnupg2 software-properties-common apt-transport-https ca-certificates
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmour -o /etc/apt/trusted.gpg.d/docker.gpg
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y containerd.io

Step 4: Configuring Containerd

Now, let's configure the containerd runtime by modifying its configuration file and restarting the service:

containerd config default | sudo tee /etc/containerd/config.toml >/dev/null 2>&1
sudo sed -i 's/SystemdCgroup \= false/SystemdCgroup \= true/g' /etc/containerd/config.toml
sudo systemctl restart containerd
sudo systemctl enable containerd

Step 5: Installing Kubernetes Components

Next, we will install the necessary Kubernetes components, including kubelet, kubeadm, and kubectl:

curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmour -o /etc/apt/trusted.gpg.d/kubernetes-xenial.gpg
sudo apt-add-repository "deb http://apt.kubernetes.io/ kubernetes-xenial main"
sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

Step 6: Initializing the Kubernetes Cluster

Now it's time to initialize our Kubernetes cluster using kubeadm. Run the following command to initiate the setup:

sudo kubeadm init --control-plane-endpoint=k8smaster.example.net

After the initialization, set up the kubeconfig file to enable kubectl to interact with the cluster:

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

Step 7: Joining Worker Nodes to the Cluster

If you have additional nodes to add to your cluster, use the following command on each worker node to join the cluster:

sudo kubeadm join k8smaster.example.net:6443 --token vt4ua6.wcma2y8pl4menxh2 \
   --discovery-token-ca-cert-hash sha256:0494aa7fc6ced8f8e7b20137ec0c5d2699dc5f8e616656932ff9173c94962a36

Step 8: Finalizing the Setup

Lastly, remove the taint on the master node so that you can schedule pods on it:

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

Conclusion

Congratulations! You have successfully configured a Kubernetes cluster on Ubuntu. You can now deploy applications on your cluster and manage them with ease. Happy Kubernetes-ing!