Atelier 02 : Les Pods : les Trois Briques du Campus Summer Portal¶
Objectifs Pédagogiques :¶
- Écrire le manifest YAML d'un Pod (
apiVersion,kind,metadata,spec) et le créer aveckubectl apply. - Suivre le cycle de vie d'un Pod avec
kubectl get,describeetlogs. - Accéder à l'application d'un Pod avec
kubectl port-forward. - Diagnostiquer un statut anormal (
ImagePullBackOff,CrashLoopBackOff) et choisir entredescribeetlogs. - Générer un manifest déclaratif avec
--dry-run=client -o yaml. - Inspecter l'intérieur du conteneur avec
kubectl exec. - Constater les limites de résilience d'un Pod isolé (bare pod).
📌 Note Compatibilité OS :
Les commandeskubectl(kubectl apply,kubectl get,kubectl describe,kubectl exec,kubectl port-forward) sont rigoureusement identiques sous Windows (PowerShell), Linux (Ubuntu) et macOS (Terminal).💻 Environnement : Minikube sur votre poste. Cet atelier se déroule entièrement sur votre cluster Minikube local. Vous éditez vos YAML dans votre IDE et lancez les commandes depuis votre terminal. Vérifiez que Minikube tourne et que
kubectlpointe dessus :minikube status # host, kubelet et apiserver : Running kubectl config use-context minikube kubectl get nodes # un nœud « minikube » à l'état ReadySi Minikube est arrêté, démarrez-le avec
minikube start.🗂️ Namespace de travail :
campus-dev. Avant de commencer, créez-le et définissez-le comme namespace courant (les commandes sont sans effet s'il existe déjà) :
Contexte Métier¶
Le portail Horizon Stages doit démarrer par la mise en ligne d'une première version de son interface web statique. En tant qu'administrateur, vous devez déployer ce premier conteneur dans un Pod, y accéder, inspecter son fonctionnement interne et constater les limites d'un Pod isolé.
- Image Docker du frontend :
regaieg/campus:frontend-1.0.0 - Port exposé par le conteneur :
8080(Nginx unprivileged)
💡 Indice : Sous Windows, quel terminal utiliser ?
Les commandes de ces ateliers sont écrites en syntaxe **Bash**. Trois pièges attendent Windows PowerShell 5.1 (le PowerShell installé par défaut) : * La redirection `> fichier.yaml` écrit en **UTF-16** : `kubectl apply` échoue ensuite à lire le fichier. Utilisez `| Out-File -Encoding utf8 fichier.yaml`. * Les commandes sur plusieurs lignes terminées par `\` et les blocs `<< 'EOF'` ne sont pas compris par PowerShell. * Les guillemets et les `$(...)` ne s'interprètent pas de la même façon. **Recommandation :** sous Windows, utilisez **Git Bash** (installé avec Git for Windows) ou **WSL**, ou bien PowerShell 7 (`winget install Microsoft.PowerShell`), qui écrit en UTF-8. **Piège propre à Git Bash :** il convertit en chemin Windows tout argument qui commence par `/`. Ainsi `kubectl run … -- md5sum /dev/urandom` (Lab 06) transmet au conteneur un chemin transformé (`md5sum: can't open '/Device/Null'`), et la commande échoue. Les labs encapsulent donc ces commandes dans `sh -c "…"`. Si vous tapez vous-même une commande de ce type, désactivez la conversion pour cette seule commande : Ne l'activez pas globalement : Git Bash ne convertirait plus non plus une variable comme `KUBECONFIG=/c/Users/...`, et `kubectl` ne trouverait plus votre cluster.Avant de construire le pod définitif du frontend, l'équipe veut un pod de test pour vérifier que l'image regaieg/campus:frontend-1.0.0 démarre bien sur le cluster. Vous allez écrire son manifest à la main, pour bien identifier les rubriques communes à tous les objets Kubernetes.
- Écrire la spécification. Créez un fichier
pod-frontend-test.yamlqui décrit un Pod avec les propriétés suivantes : - nom du Pod :
frontend-test - labels :
app: frontend-testettier: frontend - nom du conteneur :
frontend - image du conteneur :
regaieg/campus:frontend-1.0.0 - port exposé par le conteneur :
8080 - alias d'hôte (
hostAliases) : le nomcampus-backendassocié à l'adresse192.0.2.1
⚠️ Pourquoi
hostAliases? Le Nginx du frontend relaie les appels/api/vers l'hôtecampus-backend:8080et vérifie ce nom dès son démarrage : s'il est introuvable, il s'arrête (host not found in upstream "campus-backend") et le pod part enCrashLoopBackOff. Or le backend n'existe pas encore.hostAliasesajoute une ligne au fichier/etc/hostsdu conteneur : le nom existe, Nginx démarre. L'adresse192.0.2.1est réservée à la documentation et ne répond jamais. Cette astuce ne sert qu'à ce lab de test : plus tard, un vrai Service Kubernetes portera ce nom.💡 Ne précisez pas de namespace : le pod sera créé dans votre namespace courant
campus-dev(défini en début d'atelier). Indentez uniquement avec des espaces, jamais avec des tabulations.
💡 Indice 1 : squelette à compléter
Remplacez chaque `....` par la valeur demandée : Tout objet Kubernetes suit le même plan : * `apiVersion` + `kind` : le type d'objet (`v1` et `Pod`). * `metadata` : son identité (`name`, `labels`). * `spec` : l'état désiré. Pour un Pod, `containers` est une **liste de dictionnaires** : chaque conteneur commence par un tiret `-` et contient `name`, `image`, `ports`. `hostAliases` se place dans `spec`, au même niveau que `containers`. * `status` : l'état réel. Il est ajouté par Kubernetes : **vous ne l'écrivez jamais**. Pour connaître les champs disponibles : `kubectl explain pod.spec.containers`. Dans VS Code, l'extension *YAML* (Red Hat) propose l'autocomplétion et souligne les erreurs d'indentation.💡 Indice 2 : manifest complet
-
Créer le Pod à partir du fichier :
-
Suivre son démarrage jusqu'au statut
L'optionRunning:-w(watch) garde la commande ouverte et affiche chaque changement d'état :ContainerCreating(le kubelet télécharge l'image et prépare le conteneur), puisRunning. Quittez avecCtrl + C.
Affichez ensuite la vue détaillée :
Repérez la colonneNODE (le nœud choisi par le scheduler : sur Minikube, il n'y en a qu'un, minikube) et la colonne IP : chaque pod reçoit sa propre adresse IP.
💡 Indice : le pod passe en CrashLoopBackOff
Lisez la raison : `kubectl logs frontend-test`. Si vous voyez `host not found in upstream "campus-backend"`, le bloc `hostAliases` manque ou est mal indenté (il doit être dans `spec`, au même niveau que `containers`). Un pod ne se modifie pas après sa création : corrigez le fichier, puis supprimez et recréez le pod avec `kubectl delete -f pod-frontend-test.yaml` et `kubectl apply -f pod-frontend-test.yaml`.
- Observer les détails du Pod. Affichez sa description et retrouvez l'image utilisée par le conteneur
frontend, le nœud qui l'héberge et son adresse IP : Lisez la sectionEventsen bas de la sortie :Scheduled(le scheduler a choisi un nœud),Pulling/Pulled(le kubelet a téléchargé l'image),Created/Started(le conteneur a démarré). C'est le premier réflexe en cas de problème.
Comparez votre fichier avec le manifest stocké par le cluster :
Kubernetes a complété votre manifest avec des valeurs par défaut et a ajouté la rubriquestatus, qui contient l'état réel (ici la phase Running).
- Accéder à l'application via un port-forward. Ouvrez un tunnel du port
8888local vers le port8080du pod. La commande reste au premier plan tant que le tunnel est ouvert :
Ouvrez http://localhost:8888 dans votre navigateur.
La page Campus Summer Portal s'affiche : c'est le contenu servi par le pod. Les blocs de données, eux, restent vides puis affichent une erreur (502 Bad Gateway) au bout de quelques secondes à une minute selon le réseau : les appels /api/ partent vers l'adresse fictive 192.0.2.1. Le vrai backend sera branché dans les labs suivants.
Arrêtez le tunnel avec Ctrl + C, puis lisez les logs du conteneur :
"GET / HTTP/1.1" 200) et l'erreur de Nginx quand la page appelle /api/ (connect() failed … upstream: "http://192.0.2.1:8080/…"). Les logs montrent ce que fait l'application, alors que describe montre ce que fait Kubernetes.
- Provoquer une erreur classique. Lancez un pod de manière impérative (sans fichier) avec une version d'image qui n'existe pas :
Le statut passe à
ErrImagePull, puis àImagePullBackOff. Trouvez la cause avecdescribe, dans la sectionEvents:
💡 La colonne STATUS, en résumé : problème de placement ou d'image (
Pendingqui dure,ImagePullBackOff) →kubectl describe, sectionEvents. Problème dans l'application (CrashLoopBackOff) →kubectl logs.
-
Supprimer les Pods. Le pod déclaratif se supprime avec son fichier, le pod impératif avec son nom :
-
Rejouer le manifest. Les deux pods ont disparu. Recréez
Le pod revient à l'identique : même nom, mêmes labels, même image, même port, mêmefrontend-testen relançant simplement son fichier :hostAliases.
Question de réflexion : que vous faudrait-il pour recréer frontend-typo ?
Réponse : retrouver la commande exacte dans l'historique de votre terminal : rien d'autre ne l'a enregistrée.
💡
kubectl runest une commande qui sera oubliée.pod-frontend-test.yamlest un fichier que vous pouvez rejouer et versionner dans Git : c'est l'approche déclarative utilisée dans la suite de la formation.
Supprimez à nouveau le pod de test :
- Générer un manifest avec
--dry-run. Écrire un manifest à la main, comme à l'étape 1, permet de comprendre sa structure mais prend du temps et favorise les fautes d'indentation. En pratique, on ne part pas d'une page blanche : on génère un squelette propre et valide aveckubectl runcombiné avec--dry-run=client -o yaml, puis on le complète. Générez le manifestpod-frontend.yamlsans rien créer sur le cluster : - Sous Windows (PowerShell) :
-
Sous Linux (Ubuntu) / macOS (Bash) :
-
Compléter le manifest généré. Ouvrez
pod-frontend.yamldans votre éditeur et comparez-le avec celui de l'étape 1. Repérez ce quekubectla généré pour vous : le labelrun: campus-frontend,resources: {},dnsPolicy,restartPolicyetstatus: {}. Puis :- supprimez la ligne
status: {}: cette rubrique est remplie par Kubernetes, vous ne l'écrivez jamais ; - ajoutez dans
specle blochostAliasesde l'étape 1 :kubectl runne sait pas le générer, et sans lui Nginx ne démarre pas.
- supprimez la ligne
💡 Indice 3 : manifest attendu
apiVersion: v1
kind: Pod
metadata:
labels:
run: campus-frontend
name: campus-frontend
spec:
hostAliases:
- ip: "192.0.2.1"
hostnames:
- campus-backend
containers:
- image: regaieg/campus:frontend-1.0.0
name: campus-frontend
ports:
- containerPort: 8080
resources: {}
dnsPolicy: ClusterFirst
restartPolicy: Always
-
Appliquer le manifest de manière déclarative :
-
Exécuter une commande à l'intérieur du conteneur (
Affichez aussi le fichierkubectl exec) et tester la réponse HTTP du serveur web :/etc/hostsdu conteneur : la dernière ligne est celle ajoutée parhostAliases. La commande est encapsulée danssh -c "…"pour que Git Bash ne transforme pas/etc/hostsen chemin Windows (voir l'indice sur le terminal Windows en début d'atelier).💡 Précision réseau : Nous ciblons
127.0.0.1:8080plutôt quelocalhost:8080car sous les distributions légères comme Alpine Linux,localhostrésout par défaut sur IPv6 (::1), alors que le serveur Nginx écoute sur le socket IPv40.0.0.0:8080. -
Le crash-test du Pod isolé. Supprimez le pod
Question de réflexion : Le pod est-il réapparu tout seul ?campus-frontend:
Réponse : Non ! Un Pod isolé (bare pod) n'est rattaché à aucun contrôleur. S'il plante, meurt ou est supprimé, il est définitivement perdu.
👉 C'est la raison d'être des Deployments, étudiés dans le Lab 03 !
Critères de Validation (Checklist)¶
- Votre namespace courant est
campus-devet tous vos objets y sont créés (aucun objet applicatif dansdefault). - Vous savez écrire le manifest d'un Pod et retrouver son image, son nœud et son IP avec
kubectl describe pod. - Vous avez affiché le frontend via
kubectl port-forwardet savez choisir entredescribe(placement, image) etlogs(application) face à un statut anormal. - Vous maîtrisez la génération rapide de manifest avec
--dry-run=client -o yaml. - Vous savez exécuter une commande à l'intérieur du conteneur avec
kubectl execet expliquer le rôle dehostAliasesdans ce lab. - Vous avez constaté par vous-même l'absence de haute disponibilité d'un pod nu.