Kubernetes-Home-Lab/roles/kubeadm_install/README.md

Kubeadm Install

Role to configure prerequisites for installing a Kubeadm cluster

• Remove existing repos and gpg keys
• Open firewalld ports
• Disable swap
• Load modules and edit sysctl
• Install containerd
• Install kubelet, kubeadm, and kubectl

Manual Commands to match this playbook

These assume you're running sudo.

To ensure the gpg keys and repos are removed:

• rm -rf /etc/apt/sources.list.d/kubernetes.list
• rm -rf /usr/share/keyrings kubernetes-archive-keyring.gpg
• rm -rf /etc/apt/sources.list.d/docker.list
• rm -rf /usr/share/keyrings/docker-archive-keyring.gpg

To Open firewalld ports, restart, and enable firewalld: ( Do the --add-port= command for each port)

• firewall-cmd --permanent --add-port=6443/tcp
• systemctl restart firewalld
• systemctl enable firewalld

To disable swap:

• swapoff -a
• Edit /etc/fstab
  • Comment out the swap line

To check if br_netfilter and overlay modules are loaded and load them:

• lsmod | grep br_netfilter ( if nothing is output, its not loaded)
  • modprobe br_netfilter
• lsmod | grep overlay
  • modprobe overlay

Add modules to a modules-load.d config

• vi /etc/modules-load.d/k8s.conf
• Add the below to the file
  • overlay
  • br_netfilter
• hit ESC and type :wq to save and quit

Add sysctl configs to /etc/sysctl.d

• vi /etc/sysctl.d/k8s.conf
• Add the below lines to the file
  • net.bridge.bridge-nf-call-ip6tables = 1
  • net.bridge.bridge-nf-call-iptables = 1
  • net.ipv4.ip_forward = 1
• hit ESC and type :wq to save and quit

To apply the sysctl changes now type:

• sysctl --system

To install required packages to install containerd

• apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

Add docker official gpg key

• curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Setup Stable docker repository

• echo
  "deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update repo lists

• apt-get update

Install containerd

• apt-get install containerd.io

Make /etc/containerd directory

• mkdir /etc/containerd

Set containerd config default

• containerd config default | sudo tee /etc/containerd/config.toml

Restart containerd

• systemctl restart containerd

Add lines to the end of /etc/containerd/config.toml

• vi /etc/containerd/config.toml
  • [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
  • [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
  • SystemdCgroup = true
• hit ESC and type :wq to save and quit

Restart containerd

• systemctl restart containerd

Download google cloud GPG key

• sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg

Setup kubernetes repository

• echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list

Update repo lists

• apt-get update

To Install kubeadm, kubectl, and kubelet

• apt-get install kubeadm kubectl kubelet

---

Requirements

• A Sudo user on your hosts you wish to apply this to
• An internet connection

License

BSD

Author Information

An optional section for the role authors to include contact information, or a website (HTML is not allowed).