Installer Kubernetes en local : guide complet avec Minikube, Kind et K3d

Vous débutez avec Kubernetes et vous souhaitez installer un cluster sur votre machine ? Ce tutoriel installation Kubernetes local vous guide pas à pas à travers trois outils majeurs : Minikube, Kind et K3d. Selon le CNCF Annual Survey 2025, 82% des utilisateurs de conteneurs exécutent Kubernetes en production. Familiarisez-vous avec ces environnements locaux pour expérimenter sans risque avant de déployer sur des clusters de production.

TL;DR : Minikube convient aux débutants avec son interface simple, Kind excelle pour les tests CI/CD, K3d offre la meilleure performance. Choisissez selon votre cas d'usage : apprentissage, développement ou simulation multi-nœuds.

Cette compétence est au cœur de la formation LFS458 Administration Kubernetes.

Qu'est-ce qu'un cluster Kubernetes local et pourquoi l'utiliser ?

Un cluster Kubernetes local est une installation Kubernetes fonctionnant entièrement sur votre poste de travail. Cette approche vous permet d'apprendre, tester et développer sans infrastructure cloud coûteuse.

Un cluster local vous donne la liberté d'expérimenter sans conséquences sur un environnement de production.

Minikube est un outil qui crée un cluster Kubernetes mono-nœud dans une machine virtuelle ou un conteneur sur votre machine locale. Kind (Kubernetes IN Docker) est un outil qui exécute des nœuds Kubernetes sous forme de conteneurs Docker. K3d est un wrapper qui déploie K3s, une distribution Kubernetes légère, dans des conteneurs Docker.

À retenir : Un cluster local consomme entre 2 Go et 8 Go de RAM selon l'outil choisi. Vérifiez vos ressources avant l'installation.

Pour approfondir les concepts fondamentaux, consultez notre Formation Kubernetes : Guide Complet.

Quels sont les prérequis pour installer Kubernetes localement ?

Avant de commencer votre installation, vérifiez que votre système répond aux exigences suivantes. Ces prérequis s'appliquent que vous soyez ingénieur infrastructure Kubernetes, administrateur système Kubernetes ou ingénieur opérations Cloud Kubernetes.

Configuration matérielle minimale

Logiciels requis

Installez Docker sur votre système. En 2026, Docker Desktop 4.37+ ou Docker Engine 26+ sont recommandés :

# Vérifiez votre version Docker
docker --version
# Sortie attendue : Docker version 26.1.4, build 5650f9b

Installez kubectl, l'outil CLI pour interagir avec Kubernetes :

# macOS avec Homebrew
brew install kubectl

# Linux
curl -LO "https://dl.k8s.io/release/v1.32.0/bin/linux/amd64/kubectl"
chmod +x kubectl
sudo mv kubectl /usr/local/bin/

# Vérification
kubectl version --client
# Sortie : Client Version: v1.32.0

Selon la documentation officielle Kubernetes 1.32, kubectl doit correspondre à ±1 version mineure de votre cluster.

Comment installer Minikube étape par étape ?

Minikube reste l'outil le plus accessible pour vous initier à Kubernetes. Il supporte plusieurs drivers : Docker, VirtualBox, Hyper-V, et plus encore.

Étape 1 : Télécharger et installer Minikube

Exécutez ces commandes selon votre système d'exploitation :

# macOS
brew install minikube

# Linux (x86-64)
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# Windows (PowerShell admin)
choco install minikube

Étape 2 : Démarrer votre premier cluster

Lancez Minikube avec le driver Docker pour des performances optimales :

minikube start --driver=docker --kubernetes-version=v1.32.0

# Sortie attendue :
# 🎉  minikube v1.35.0 on Darwin 14.5
# ✨  Using the docker driver based on user configuration
# 🔥  Creating docker container (CPUs=2, Memory=4096MB)
# 🐳  Preparing Kubernetes v1.32.0 on Docker 26.1.4
# 🏄  Done! kubectl is now configured to use "minikube" cluster

Étape 3 : Vérifier l'installation

Confirmez que votre cluster fonctionne correctement :

kubectl cluster-info
# Sortie : Kubernetes control plane is running at https://127.0.0.1:55000

kubectl get nodes
# Sortie : minikube   Ready    control-plane   2m   v1.32.0

À retenir : Minikube inclut un dashboard intégré. Lancez-le avec minikube dashboard pour visualiser vos ressources.

Pour aller plus loin avec vos premiers déploiements, suivez notre guide Déployer votre premier pod Kubernetes en 15 minutes.

Comment installer Kind pour vos tests CI/CD ?

Kind excelle dans les pipelines CI/CD. D'après Kubernetes SIG Testing, Kind est utilisé pour les tests end-to-end du projet Kubernetes lui-même depuis 2018.

Étape 1 : Installer Kind

Téléchargez Kind via votre gestionnaire de paquets :

# macOS / Linux avec Homebrew
brew install kind

# Linux binaire direct
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.25.0/kind-linux-amd64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

# Vérification
kind version
# Sortie : kind v0.25.0 go1.23.0 linux/amd64

Étape 2 : Créer un cluster mono-nœud

Démarrez un cluster basique en une commande :

kind create cluster --name mon-cluster-dev

# Sortie attendue :
# Creating cluster "mon-cluster-dev" ...
#  ✓ Ensuring node image (kindest/node:v1.32.0) 🖼
#  ✓ Preparing nodes 📦
#  ✓ Writing configuration 📜
#  ✓ Starting control-plane 🕹️
#  ✓ Installing CNI 🔌
#  ✓ Installing StorageClass 💾
# Set kubectl context to "kind-mon-cluster-dev"

Étape 3 : Créer un cluster multi-nœuds

Pour simuler un environnement de production, créez un fichier de configuration kind-config.yaml :

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
  - role: worker
  - role: worker

Appliquez cette configuration :

kind create cluster --name cluster-prod --config kind-config.yaml

kubectl get nodes
# Sortie :
# cluster-prod-control-plane   Ready   control-plane   45s   v1.32.0
# cluster-prod-worker          Ready   <none>          20s   v1.32.0
# cluster-prod-worker2         Ready   <none>          20s   v1.32.0

Cette configuration multi-nœuds vous prépare aux examens de certification. Découvrez les Tutoriels et guides pratiques Kubernetes pour approfondir vos compétences.

Comment installer K3d pour des clusters ultra-légers ?

K3d déploie K3s, la distribution Kubernetes de Rancher certifiée CNCF. Selon Rancher Labs (2024), K3s consomme 50% moins de mémoire que le Kubernetes standard.

Étape 1 : Installer K3d

Exécutez le script d'installation officiel :

# Installation via script
curl -s https://raw.githubusercontent.com/k3d-io/k3d/main/install.sh | bash

# Ou via Homebrew
brew install k3d

# Vérification
k3d version
# Sortie : k3d version v5.8.0

Étape 2 : Créer un cluster K3d

Lancez un cluster avec exposition du port pour l'Ingress :

k3d cluster create dev-cluster \
  --servers 1 \
  --agents 2 \
  --port "8080:80@loadbalancer"

# Sortie attendue :
# INFO[0000] Prep: Network
# INFO[0000] Created network 'k3d-dev-cluster'
# INFO[0001] Created node 'k3d-dev-cluster-server-0'
# INFO[0001] Created node 'k3d-dev-cluster-agent-0'
# INFO[0001] Created node 'k3d-dev-cluster-agent-1'
# INFO[0005] Cluster 'dev-cluster' created successfully!

Étape 3 : Configurer l'accès kubectl

Vérifiez que kubectl pointe vers votre nouveau cluster :

kubectl config current-context
# Sortie : k3d-dev-cluster

kubectl get nodes -o wide
# Sortie :
# NAME                       STATUS   ROLES                  VERSION
# k3d-dev-cluster-server-0   Ready    control-plane,master   v1.31.2+k3s1
# k3d-dev-cluster-agent-0    Ready    <none>                 v1.31.2+k3s1
# k3d-dev-cluster-agent-1    Ready    <none>                 v1.31.2+k3s1

À retenir : K3d démarre un cluster complet en moins de 30 secondes. Utilisez-le pour vos cycles de développement rapides.

Pour configurer le réseau de votre cluster, consultez Référence rapide NetworkPolicies : contrôler le trafic réseau Kubernetes.

Quel outil choisir selon votre cas d'usage ?

Votre choix dépend de vos objectifs professionnels et de votre contexte technique.

Choisissez Minikube si vous débutez et souhaitez un environnement avec dashboard et addons prêts à l'emploi.

Optez pour Kind si vous travaillez sur des pipelines CI/CD ou testez des configurations multi-nœuds complexes.

Préférez K3d si vous avez des ressources limitées ou besoin de cycles de développement ultra-rapides.

Pour évaluer d'autres plateformes de pratique, lisez Notre avis sur les meilleures plateformes de labs Kubernetes pour se former.

Comment résoudre les problèmes courants d'installation ?

Vous rencontrerez probablement ces erreurs lors de vos premières installations. Identifiez et corrigez-les rapidement.

Docker daemon non accessible

# Erreur : Cannot connect to Docker daemon
# Solution : Démarrez Docker et vérifiez les permissions
sudo systemctl start docker
sudo usermod -aG docker $USER
# Déconnectez-vous et reconnectez-vous

Mémoire insuffisante

# Erreur : Exiting due to MK_USAGE: memory 2048MB is below minimum 4096MB
# Solution pour Minikube : Réduisez la RAM requise
minikube start --memory=3072

Conflit de ports

# Erreur : Port 80 already in use
# Solution pour K3d : Utilisez un autre port
k3d cluster create test --port "8888:80@loadbalancer"

Cluster qui ne démarre pas

Supprimez et recréez votre cluster pour repartir de zéro :

# Minikube
minikube delete && minikube start

# Kind
kind delete cluster --name mon-cluster && kind create cluster

# K3d
k3d cluster delete dev-cluster && k3d cluster create dev-cluster

Consultez la Carte thématique Formation Kubernetes pour naviguer vers d'autres ressources de dépannage.

Comment valider votre installation avec un déploiement test ?

Confirmez que votre cluster fonctionne en déployant une application simple :

# Créez un déploiement nginx
kubectl create deployment nginx-test --image=nginx:1.27

# Exposez-le via un service
kubectl expose deployment nginx-test --port=80 --type=NodePort

# Vérifiez le statut
kubectl get pods,svc
# Sortie attendue :
# NAME                              READY   STATUS    RESTARTS   AGE
# pod/nginx-test-7c79c4bf97-x2lkj   1/1     Running   0          30s
# 
# NAME                 TYPE        CLUSTER-IP      PORT(S)
# service/nginx-test   NodePort    10.96.123.45    80:31234/TCP

Testez l'accès selon votre outil :

# Minikube
minikube service nginx-test --url

# Kind / K3d
kubectl port-forward svc/nginx-test 8080:80
# Ouvrez http://localhost:8080 dans votre navigateur

Cette validation confirme que votre environnement est prêt pour des déploiements plus complexes. Explorez Configurer un Ingress Controller Kubernetes pas à pas : Nginx et Traefik pour la suite.

Passez à l'étape suivante : de l'installation à la maîtrise

Vous avez installé un cluster Kubernetes local fonctionnel. Cette base vous permet de pratiquer les concepts essentiels : Pods, Deployments, Services, ConfigMaps. Les formations certifiantes SFEIR vous accompagnent vers la maîtrise complète.

Pour les ingénieurs infrastructure et administrateurs système, la formation LFS458 Administration Kubernetes (4 jours) vous prépare à la certification CKA avec des labs intensifs sur clusters multi-nœuds.

Les développeurs d'applications trouveront dans la formation LFD459 Kubernetes pour les développeurs (3 jours) les compétences pour déployer et gérer des applications conteneurisées.

Découvrez les prochaines sessions sur notre calendrier de formations, ou consultez notre section Déploiement et mise en production Kubernetes pour les prochaines étapes de votre parcours.