00, Setup : Minikube, Helm et kubectl

Ce module installe l'environnement nécessaire à toute la formation. À la fin, vous aurez un cluster Kubernetes local prêt à recevoir la stack d'observabilité.

Prérequis système

RAM : 8 Go minimum (16 Go recommandés)
CPU : 4 cœurs disponibles
Disque : 20 Go libres

Installation

kubectl

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
rm kubectl
kubectl version --client

Minikube

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube
rm minikube-linux-amd64
minikube version

Helm

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version

kubectl

brew install kubectl
kubectl version --client

Minikube

brew install minikube
minikube version

Helm

brew install helm
helm version

kubectl

choco install kubernetes-cli
kubectl version --client

Minikube

choco install minikube
minikube version

Helm

choco install kubernetes-helm
helm version

Vérification automatique

Si vous avez cloné le dépôt, utilisez le script de vérification :

git clone https://github.com/stephrobert/lab-observability.git
cd lab-observability
chmod +x 00-setup/verify.sh
./00-setup/verify.sh

Sortie attendue :

=== Vérification des prérequis ===

✅ minikube : minikube version: v1.37.0
✅ kubectl : error: unknown flag: --short
✅ helm : v4.1.0+g4553a0a
✅ docker : Docker version 29.1.3, build f52814d

=== Vérification des ressources ===
✅ RAM : 46 Go disponibles

✅ Tous les prérequis sont satisfaits !

Prochaine étape :
  minikube start --memory=10240 --cpus=4 --driver=docker

Démarrer Minikube

Créez votre cluster avec suffisamment de ressources pour la formation :

minikube start \
  --memory=10240 \
  --cpus=4 \
  --driver=docker \
  --kubernetes-version=v1.32.0

Vérifiez que le cluster fonctionne :

kubectl cluster-info
kubectl get nodes

Sortie attendue :

Kubernetes control plane is running at https://192.168.49.2:8443
CoreDNS is running at https://192.168.49.2:8443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

NAME       STATUS   ROLES           AGE     VERSION
minikube   Ready    control-plane   2m14s   v1.32.0

Configurer les addons utiles

Activez quelques addons qui faciliteront le travail :

# Metrics server (pour kubectl top)
minikube addons enable metrics-server

# Dashboard Kubernetes (optionnel)
minikube addons enable dashboard

# Ingress (pour exposer les services)
minikube addons enable ingress

Vérifiez les addons actifs :

minikube addons list | grep enabled

Ajouter les repos Helm

Ajoutez les repositories Helm nécessaires pour la formation :

# Prometheus Community (Prometheus, Alertmanager)
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts

# Grafana (Grafana, Loki, Tempo)
helm repo add grafana-community https://grafana-community.github.io/helm-charts

# OpenTelemetry
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts

# Mettre à jour les repos
helm repo update

Vérifiez :

helm repo list

Créer les namespaces

Préparez les namespaces pour la formation :

# Namespace pour les outils d'observabilité
kubectl create namespace observability

# Namespace pour l'application démo
kubectl create namespace otel-demo

Vérifiez :

kubectl get namespaces

Commandes utiles à retenir

Commande	Description
`minikube start`	Démarrer le cluster
`minikube stop`	Arrêter (sans perdre les données)
`minikube delete`	Supprimer (reset complet)
`minikube dashboard`	Ouvrir le dashboard K8s
`minikube service <svc> -n <ns>`	Ouvrir un service dans le navigateur
`minikube tunnel`	Exposer les LoadBalancer

Dépannage

"Not enough memory"

Réduisez la mémoire allouée (minimum 4 Go, mais 8 Go recommandés) :

minikube delete
minikube start --memory=4096 --cpus=2

"Driver docker not found"

Vérifiez que Docker est démarré :

docker ps

Si Docker tourne mais Minikube ne le trouve pas, ajoutez votre utilisateur au groupe docker :

sudo usermod -aG docker $USER
newgrp docker

"kubectl connection refused"

Le cluster n'est pas démarré ou le contexte n'est pas bon :

minikube start
kubectl config use-context minikube

Validation

Avant de passer au module suivant, vérifiez que tout fonctionne :

# Cluster actif
kubectl get nodes

# Namespaces créés
kubectl get ns observability otel-demo

# Repos Helm configurés
helm repo list | grep -E "prometheus|grafana|open-telemetry"

Si tout est vert, vous êtes prêt pour le module suivant.

Prochaine étape

01, Application démo → Déployer OpenTelemetry Demo pour avoir des métriques, logs et traces.