Déployer votre premier pod Kubernetes en 15 minutes

Vous voulez lancer votre premier pod Kubernetes ? Ce tutoriel débutant vous guide pas à pas, de l'installation à l'exécution d'un conteneur fonctionnel. En 15 minutes, vous apprendrez les commandes essentielles que tout développeur Backend Kubernetes, développeur Full-Stack Kubernetes ou ingénieur logiciel Kubernetes doit connaître.

TL;DR

Vous allez installer Minikube, créer votre premier pod avec kubectl run, vérifier son état et accéder aux logs. Chaque étape inclut la commande exacte et le résultat attendu.

Pour approfondir ces compétences, découvrez la formation Kubernetes, les fondamentaux.

Pourquoi apprendre à déployer un premier pod Kubernetes en tutoriel débutant ?

Selon le CNCF Annual Survey 2025, 82% des utilisateurs de conteneurs exécutent Kubernetes en production. Cette adoption massive signifie que vous devez connaître les bases pour rester compétitif sur le marché.

« Anybody can learn Kubernetes. With abundant documentation and development tools available online, teaching yourself Kubernetes is very much within reach. » — The Enterprisers Project

Un pod représente l'unité d'exécution la plus petite dans Kubernetes. Il encapsule un ou plusieurs conteneurs partageant le même réseau et stockage. Comprendre ce concept fondamental vous ouvre la porte vers l'orchestration de conteneurs à grande échelle.

À retenir : Le pod est à Kubernetes ce que le conteneur est à Docker. Vous ne déployez jamais un conteneur directement, mais toujours via un pod.

Prérequis : ce dont vous avez besoin avant de commencer

Vérifiez votre environnement avant de poursuivre ce premier pod Kubernetes tutoriel débutant :

Installez kubectl si ce n'est pas déjà fait :

# macOS
brew install kubectl

# Linux (Debian/Ubuntu)
sudo apt-get update && sudo apt-get install -y kubectl

# Windows (avec Chocolatey)
choco install kubernetes-cli

Consultez l'aide-mémoire kubectl : toutes les commandes essentielles Kubernetes pour une référence complète des commandes.

Étape 1 : Installer et démarrer Minikube

Minikube crée un cluster Kubernetes local sur votre machine. Téléchargez et installez selon votre système :

# macOS
brew install minikube

# Linux
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

Démarrez votre cluster avec la commande suivante :

minikube start --driver=docker

Résultat attendu :

😄  minikube v1.32.0 on Darwin
✨  Using the docker driver based on user configuration
📌  Using Docker Desktop driver with root privileges
🔥  Creating kubernetes in docker container
🐳  Preparing Kubernetes v1.28.3 on Docker
🏄  Done! kubectl is now configured to use "minikube" cluster

À retenir : Minikube simule un cluster complet sur votre poste. Vous pouvez expérimenter sans risquer d'affecter un environnement de production.

Étape 2 : Vérifier la connexion à votre cluster

Confirmez que kubectl communique correctement avec votre cluster :

kubectl cluster-info

Vous devez voir :

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

Listez les nœuds disponibles :

kubectl get nodes

NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   2m    v1.28.3

Cette étape valide que votre environnement fonctionne. Les tutoriels et guides pratiques Kubernetes couvrent des configurations plus avancées.

Étape 3 : Créer votre premier pod avec kubectl run

Lancez un pod nginx avec une seule commande :

kubectl run mon-premier-pod --image=nginx:1.25 --port=80

pod/mon-premier-pod created

Cette commande effectue trois actions :

1. Télécharge l'image nginx:1.25 depuis Docker Hub
2. Crée un pod nommé "mon-premier-pod"
3. Configure le conteneur pour écouter sur le port 80

Étape 4 : Vérifier l'état de votre pod

Surveillez le déploiement de votre pod :

kubectl get pods

NAME              READY   STATUS    RESTARTS   AGE
mon-premier-pod   1/1     Running   0          30s

Les statuts possibles :

Obtenez des détails complets sur votre pod :

kubectl describe pod mon-premier-pod

Cette commande affiche les événements, les conditions et la configuration complète. Le développeur Backend Kubernetes l'utilise quotidiennement pour diagnostiquer les problèmes.

À retenir : kubectl describe est votre outil de diagnostic principal. Vous y trouverez les erreurs de pull d'image, les problèmes de ressources et les échecs de health checks.

Étape 5 : Accéder aux logs du conteneur

Consultez la sortie standard de votre conteneur :

kubectl logs mon-premier-pod

/docker-entrypoint.sh: Configuration complete; ready for start up
2026/02/28 10:15:32 [notice] 1#1: nginx/1.25.4
2026/02/28 10:15:32 [notice] 1#1: start worker processes

Suivez les logs en temps réel avec l'option -f :

kubectl logs -f mon-premier-pod

Appuyez sur Ctrl+C pour quitter le mode suivi. Ces commandes sont essentielles pour tout ingénieur logiciel Kubernetes qui débogue des applications en production.

Étape 6 : Exécuter des commandes dans le pod

Ouvrez un shell interactif dans votre conteneur :

kubectl exec -it mon-premier-pod -- /bin/bash

Vous êtes maintenant à l'intérieur du conteneur. Testez nginx :

curl localhost:80

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
...

Quittez le shell avec exit. Cette technique vous permet de déboguer directement dans l'environnement d'exécution.

Étape 7 : Exposer votre pod localement

Créez un port-forward pour accéder au pod depuis votre navigateur :

kubectl port-forward mon-premier-pod 8080:80

Forwarding from 127.0.0.1:8080 -> 80

Ouvrez votre navigateur à l'adresse http://localhost:8080. Vous voyez la page d'accueil nginx. Le développeur Full-Stack Kubernetes utilise cette méthode pour tester ses applications avant de configurer un Ingress.

Pour aller plus loin, consultez Configurer un Ingress Controller Kubernetes pas à pas : Nginx et Traefik.

Nettoyer votre environnement

Supprimez le pod une fois l'exercice terminé :

kubectl delete pod mon-premier-pod

pod "mon-premier-pod" deleted

Arrêtez Minikube pour libérer les ressources :

minikube stop

Selon le rapport Spectro Cloud State of Kubernetes 2025, les équipes IT passent en moyenne 34 jours de travail par an à résoudre des problèmes Kubernetes. Connaître les bases vous fait gagner un temps précieux.

Ce que vous avez appris

Vous savez maintenant :

• Installer et démarrer un cluster local avec Minikube
• Créer un pod avec kubectl run
• Vérifier l'état avec kubectl get et kubectl describe
• Consulter les logs avec kubectl logs
• Accéder au conteneur avec kubectl exec
• Exposer un pod avec kubectl port-forward

Quelle est la prochaine étape pour un développeur Backend Kubernetes ?

Votre premier pod fonctionne. Continuez votre apprentissage avec ces ressources :

• Comparatifs et alternatives Kubernetes pour comprendre l'écosystème
• Formation Kubernetes : Guide Complet pour une vue d'ensemble

Consultez notre calendrier de formations pour les prochaines sessions en présentiel.

Passez à l'action : formez-vous avec SFEIR

Vous avez déployé votre premier pod. Accélérez votre montée en compétences avec des formations certifiantes :

• Kubernetes, les fondamentaux : découvrez l'orchestration de conteneurs en 1 jour
• LFS458 Administration Kubernetes : préparez la certification CKA en 4 jours
• LFD459 Kubernetes pour les développeurs d'applications : préparez le CKAD en 3 jours

Contactez nos conseillers pour démarrer votre parcours de certification.