Contactez-nous

Vérification de l'installation et première connexion au cluster

Confirmez que votre installation Kubernetes locale (Minikube/Kind) est opérationnelle et que kubectl peut communiquer avec votre nouveau cluster.

Confirmation finale : le pont est établi

Félicitations ! Vous avez installé kubectl et démarré votre premier cluster Kubernetes local avec Minikube ou Kind. Cependant, avant de nous lancer dans le déploiement d'applications, il est crucial de s'assurer que tous les composants communiquent correctement. Cette étape de vérification confirme que kubectl est bien configuré pour parler à votre nouveau cluster.

Lorsque vous avez démarré Minikube ou Kind, l'outil a normalement mis à jour automatiquement un fichier spécial appelé kubeconfig. Ce fichier contient les informations nécessaires (adresse du serveur API, certificats d'authentification) pour que kubectl puisse se connecter de manière sécurisée à un ou plusieurs clusters. Par défaut, ce fichier se trouve généralement dans ~/.kube/config sur Linux et macOS, ou %USERPROFILE%\.kube\config sur Windows.

Nous allons maintenant utiliser quelques commandes kubectl simples pour interroger le cluster et confirmer que la connexion est bien établie et que le cluster est prêt à recevoir des instructions.

Vérifier le contexte et les informations du cluster

Le fichier kubeconfig peut contenir les informations de connexion pour plusieurs clusters. Le "contexte" définit quel cluster est actuellement ciblé par vos commandes kubectl. Minikube et Kind définissent généralement leur propre contexte et le rendent actif lors du démarrage. Vérifions le contexte actuel :

kubectl config current-context
La sortie devrait indiquer le nom du contexte associé à votre cluster local (par exemple, minikube ou kind-kind si vous avez utilisé le nom par défaut pour Kind). Si ce n'est pas le cas, vous pouvez lister tous les contextes avec kubectl config get-contexts et basculer vers le bon contexte avec kubectl config use-context .

Une fois assuré que vous ciblez le bon cluster, la commande la plus fondamentale pour vérifier la connectivité est kubectl cluster-info :

kubectl cluster-info
Si la connexion réussit, cette commande affichera l'URL du Control Plane (le serveur API principal) et potentiellement l'URL d'autres services du cluster comme CoreDNS.

Exemple de sortie attendue (les URLs et ports peuvent varier) :

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

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.
Obtenir cette sortie sans message d'erreur est un excellent signe que kubectl communique bien avec le coeur de votre cluster.

Inspecter les Noeuds (Nodes) du cluster

Pour aller un peu plus loin, vérifions si les machines de travail (les Noeuds) de votre cluster sont prêtes à exécuter des applications. Rappelez-vous, Minikube crée typiquement un cluster avec un seul Noeud (qui fait office à la fois de Control Plane et de worker), tandis que Kind peut en créer un ou plusieurs.

Utilisez la commande suivante pour lister les Noeuds présents dans votre cluster :

kubectl get nodes
Vous devriez voir au moins un Noeud listé, avec un statut Ready. Le statut Ready indique que le Noeud est sain et prêt à accepter des Pods.

Exemple de sortie pour un cluster Minikube ou Kind mono-noeud :

NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   Xm    v1.XX.X
Ou pour un cluster Kind multi-noeuds (1 control-plane, 2 workers) :
NAME                 STATUS   ROLES           AGE   VERSION
kind-control-plane   Ready    control-plane   Xm    v1.XX.X
kind-worker          Ready              Xm    v1.XX.X
kind-worker2         Ready              Xm    v1.XX.X
Si vous voyez vos Noeuds avec le statut Ready, votre cluster Kubernetes local est bel et bien opérationnel et prêt pour l'action !

En cas de problème (par exemple, des erreurs de connexion ou des noeuds non prêts), vérifiez d'abord que votre outil de cluster local est bien démarré (minikube status ou vérifiez que les conteneurs Docker de Kind sont en cours d'exécution : docker ps). Assurez-vous également que votre contexte kubectl est correctement défini.

Prêt à déployer : votre environnement est configuré !

Si vous avez suivi les étapes de ce chapitre et que les commandes de vérification ont fonctionné, félicitations ! Vous disposez maintenant d'un environnement de travail Kubernetes local entièrement fonctionnel. Vous avez installé l'outil essentiel kubectl et vous avez un mini-cluster Kubernetes qui tourne sur votre machine, prêt à être utilisé.

Cette configuration est la base indispensable pour aborder la suite de ce cours. Vous allez pouvoir expérimenter concrètement la création de Pods, de Déploiements, de Services, et comprendre comment ces objets interagissent au sein du cluster.

Gardez votre terminal ouvert et votre cluster local actif. Dans la partie suivante, nous allons commencer à explorer les briques essentielles de Kubernetes en créant nos premières ressources !