Configuration d'un nœud Master Kubernetes sur Debian 12 avec containerd

---

1. Mise à jour du système et installation des outils de base

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl gnupg2 apt-transport-https ca-certificates software-properties-common

---

2. Installation de containerd

sudo apt install -y containerd
sudo mkdir -p /etc/containerd
sudo containerd config default | sudo tee /etc/containerd/config.toml
sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
sudo systemctl restart containerd
sudo systemctl enable containerd
sudo systemctl status containerd

L'option SystemdCgroup = true est obligatoire pour que containerd s'intègre correctement avec kubelet via systemd.

---

3. Désactivation du swap

Le swap doit être désactivé - Kubernetes ne fonctionne pas correctement avec le swap actif.

sudo swapoff -a
sudo sed -i '/ swap / s/^(.*)$/#1/g' /etc/fstab

La commande sed commente la ligne swap dans /etc/fstab pour que la désactivation soit persistante après redémarrage.

---

4. Configuration des modules du noyau et paramètres réseau

cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF

sudo modprobe overlay
sudo modprobe br_netfilter

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

sudo sysctl --system

Paramètre	Rôle
overlay	Système de fichiers en couches pour les conteneurs
br_netfilter	Permet au bridge réseau de passer par iptables
ip_forward	Active le routage IP entre les interfaces

---

5. Ajouter le dépôt Kubernetes et la clé GPG

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.32/deb/Release.key | 
  sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg

echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] 
https://pkgs.k8s.io/core:/stable:/v1.32/deb/ /" | 
sudo tee /etc/apt/sources.list.d/kubernetes.list

---

6. Installer kubelet, kubeadm et kubectl

sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

apt-mark hold empêche une mise à jour automatique des composants Kubernetes, ce qui pourrait casser le cluster.

---

7. Initialiser le cluster Kubernetes

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

Le CIDR 10.244.0.0/16 est recommandé pour le plugin réseau Flannel.

À la fin de l'initialisation, kubeadm affiche une commande kubeadm join à conserver pour ajouter des nœuds workers.

---

8. Configurer kubectl pour l'utilisateur courant

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

---

9. Installer le plugin réseau Flannel

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

---

10. Vérifier l'état du nœud Master

kubectl get nodes

Résultat attendu :

NAME     STATUS   ROLES           AGE   VERSION
master   Ready    control-plane   5m    v1.32.0

---

11. Dépannage - Flannel / CNI

Si les pods Flannel restent en CrashLoopBackOff ou que le nœud reste en NotReady, c'est souvent lié à un chemin CNI manquant. Créer le lien symbolique suivant :

sudo ln -s /opt/cni/bin /usr/lib/cni

Puis redémarrer les pods Flannel :

kubectl rollout restart daemonset/kube-flannel-ds -n kube-flannel
kubectl get pods -n kube-flannel

---

Récapitulatif - Ordre d'installation

Étape	Action
1	Mettre à jour le système et installer les dépendances
2	Installer et configurer containerd (SystemdCgroup = true)
3	Désactiver le swap (temporaire + persistant via fstab)
4	Charger les modules noyau et paramètres réseau
5	Ajouter le dépôt Kubernetes v1.32
6	Installer kubelet, kubeadm, kubectl (avec hold)
7	Initialiser le cluster (kubeadm init)
8	Configurer kubectl pour l'utilisateur
9	Installer Flannel
10	Vérifier kubectl get nodes → STATUS Ready
11	Si Flannel KO : sudo ln -s /opt/cni/bin /usr/lib/cni