Guide 02 / 3
Commandes Kubernetes · kubectl
Utiliser kubectl pour observer, déployer, dépanner et administrer un cluster de formation.
Choisir une commande, vérifier sa portée et diagnostiquer un déploiement sans intervention destructive inutile.
01 · Contexte et connexion
Avant chaque manipulation, vérifier sur quel cluster et dans quel namespace les commandes seront exécutées.
kubectl version --client
Affiche la version du client installé, sans nécessiter un accès fonctionnel au cluster.
Exemple
kubectl version --client
kubectl cluster-info
Affiche les adresses des principaux services du cluster joignable.
Exemple
kubectl cluster-info
kubectl config get-contexts
Liste les contextes du kubeconfig : un contexte combine cluster, identité et namespace par défaut.
Exemple
kubectl config get-contexts
kubectl config current-context
Affiche le contexte actif afin d’éviter d’agir sur un mauvais environnement.
Exemple
kubectl config current-context
kubectl config use-context
Change le contexte utilisé par défaut dans la configuration locale kubectl.
Exemple
kubectl config use-context lab
Attention à ne pas basculer accidentellement en production.
kubectl get namespaces
Liste les namespaces accessibles du cluster.
Exemple
kubectl get ns
kubectl config set-context --current --namespace
Fixe le namespace par défaut du contexte courant, sans changer de cluster.
Exemple
kubectl config set-context --current --namespace=dev
02 · Observer les ressources
La démarche de diagnostic commence par une vue d’ensemble, puis l’état et les événements d’une ressource précise.
kubectl get
Liste les ressources de type donné dans le namespace courant.
Exemple
kubectl get pods
kubectl get -A / -n
-A cible tous les namespaces ; -n en choisit un précis pour les ressources namespacées.
Exemple
kubectl get pods -A
kubectl get pods -n dev
kubectl get -o wide
Ajoute des colonnes comme IP du Pod et nœud de placement selon le type de ressource.
Exemple
kubectl get pods -o wide
kubectl get -o yaml
Affiche la représentation YAML complète renvoyée par l’API, y compris des champs gérés par le cluster.
Exemple
kubectl get deployment web -o yaml
Ne pas réutiliser tels quels uid et resourceVersion dans un manifeste.
kubectl describe
Produit une description lisible avec état, configuration, erreurs et événements.
Exemple
kubectl describe pod web-abc123
kubectl get events
Montre les événements du cluster ou du namespace : échecs de placement, démarrage ou montage.
Exemple
kubectl get events -n dev --sort-by=.metadata.creationTimestamp
kubectl api-resources
Liste les types de ressources reconnus par l’API et leurs noms courts éventuels.
Exemple
kubectl api-resources
kubectl explain
Explique les champs attendus par un objet de l’API à l’aide du schéma connu du cluster.
Exemple
kubectl explain deployment.spec.template.spec.containers
03 · Déclarer, créer et modifier
Pour les applications durables, conserver les manifestes YAML dans Git et appliquer leurs changements de manière contrôlée.
kubectl apply -f
Crée ou met à jour les ressources déclarées dans un fichier ou un répertoire.
Exemple
kubectl apply -f deployment.yaml
kubectl apply -f ./manifests/
kubectl diff -f
Affiche les différences prévues entre le cluster et les manifestes avant leur application.
Exemple
kubectl diff -f ./manifests/
Selon le contexte, peut nécessiter des droits supplémentaires côté serveur.
kubectl apply --dry-run=server
Demande une validation côté serveur sans persister l’objet ; utile avant application.
Exemple
kubectl apply --dry-run=server -f deployment.yaml
La validation ne garantit pas la disponibilité des images ou du stockage.
kubectl create namespace
Crée rapidement un namespace ; utile en TP ou pour initialiser un environnement.
Exemple
kubectl create namespace dev
kubectl create deployment
Crée un Deployment depuis la ligne de commande, utile pour une démonstration rapide.
Exemple
kubectl create deployment web --image=nginx:stable
kubectl edit
Ouvre l’éditeur local pour modifier un objet existant puis soumettre les modifications à l’API.
Exemple
kubectl edit deployment web
Pour une configuration reproductible, reporter ensuite le changement dans Git.
kubectl delete
Supprime des ressources ciblées, dans le namespace ou contexte sélectionné.
Exemple
kubectl delete -f deployment.yaml
Vérifier les volumes et objets dépendants avant suppression.
04 · Diagnostic d’un Pod
Pour une application qui ne démarre pas : état → describe → événements → logs → contrôle réseau et configuration.
kubectl logs
Affiche les journaux d’un Pod, éventuellement en précisant le conteneur concerné.
Exemple
kubectl logs pod/web-abc -c nginx
kubectl logs -f / --previous
-f suit les journaux ; --previous consulte l’instance précédente d’un conteneur redémarré.
Exemple
kubectl logs -f deployment/web
kubectl logs pod/web-abc --previous
kubectl exec
Exécute une commande dans un conteneur en cours d’exécution, si l’image contient cette commande.
Exemple
kubectl exec -it pod/web-abc -- sh
kubectl port-forward
Redirige un port local vers un Pod ou un Service via la connexion kubectl, sans publier un Service externe.
Exemple
kubectl port-forward svc/web 8080:80
Accès temporaire de diagnostic, pas une publication de production.
kubectl cp
Copie des fichiers entre poste local et conteneur ; dépend notamment de tar dans le conteneur.
Exemple
kubectl cp dev/web-abc:/tmp/test.log ./test.log
kubectl top
Affiche l’usage CPU/mémoire lorsque l’API de métriques, par exemple metrics-server, est disponible.
Exemple
kubectl top pods
kubectl top nodes
kubectl debug
Permet du débogage plus avancé, par exemple avec un conteneur éphémère ou une copie de Pod.
Exemple
kubectl debug -it pod/web-abc --image=busybox:1.36 --target=nginx
Nécessite les droits et le support adéquats du cluster.
05 · Déployer, dimensionner et revenir en arrière
La mise à jour d’un Deployment gère la transition vers la nouvelle version de ses Pods.
kubectl scale
Modifie le nombre de répliques d’une ressource prenant en charge cette opération.
Exemple
kubectl scale deployment/web --replicas=3
kubectl set image
Met à jour la référence d’image d’un conteneur dans un Deployment ou objet compatible.
Exemple
kubectl set image deployment/web nginx=nginx:stable
Préférer une référence d’image immuable ou un tag versionné.
kubectl rollout status
Attend ou vérifie la progression du déploiement, avec un timeout possible.
Exemple
kubectl rollout status deployment/web --timeout=120s
kubectl rollout history
Affiche les révisions enregistrées pour un Deployment, si l’historique est disponible.
Exemple
kubectl rollout history deployment/web
kubectl rollout undo
Demande le retour à une révision antérieure d’un Deployment.
Exemple
kubectl rollout undo deployment/web
Le rollback ne restaure pas les données métier.
kubectl rollout restart
Déclenche un nouveau cycle de déploiement en mettant à jour le template de Pod.
Exemple
kubectl rollout restart deployment/web
06 · Administration courante et permissions
Les opérations sur les nœuds et les autorisations doivent être réservées aux personnes habilitées.
kubectl get nodes
Affiche les nœuds du cluster et leur disponibilité.
Exemple
kubectl get nodes -o wide
kubectl cordon
Empêche la planification de nouveaux Pods ordinaires sur un nœud, sans déplacer les Pods existants.
Exemple
kubectl cordon worker-1
kubectl drain
Évacue les Pods concernés d’un nœud pour une maintenance, en respectant certaines protections.
Exemple
kubectl drain worker-1 --ignore-daemonsets
À lancer uniquement sur un environnement autorisé ; impacts applicatifs possibles.
kubectl uncordon
Réautorise la planification de Pods sur un nœud précédemment bloqué.
Exemple
kubectl uncordon worker-1
kubectl auth can-i
Vérifie si l’identité active est autorisée à effectuer une action précise dans un périmètre.
Exemple
kubectl auth can-i get secrets -n dev
kubectl get pvc,pv,storageclass
Inspecte les demandes, volumes disponibles et classes de stockage.
Exemple
kubectl get pvc -n dev
kubectl get pv,storageclass
kubectl get svc,ingress
Inspecte les Services et règles d’entrée HTTP du namespace.
Exemple
kubectl get svc,ingress -n dev
kubectl get configmap,secret
Liste les objets de configuration du namespace ; les valeurs secrètes ne sont pas affichées par défaut.
Exemple
kubectl get configmaps,secrets -n dev
Ne jamais journaliser ou publier le contenu réel des Secrets.
07 · Options utiles et bonnes pratiques
Les options de kubectl évitent des erreurs de portée et facilitent l’automatisation.
--context / --namespace
Ciblent explicitement le cluster et le namespace sans modifier la configuration persistante locale.
Exemple
kubectl --context lab -n dev get pods
-l / --selector
Filtre les objets selon leurs labels ; permet de viser un sous-ensemble fonctionnel.
Exemple
kubectl get pods -l app=web
-o jsonpath
Extrait des champs précis de la réponse API, utile pour scripts et automatisation.
Exemple
kubectl get pod web-abc -o jsonpath="{.status.phase}"
--watch / -w
Observe en continu les modifications d’une liste de ressources.
Exemple
kubectl get pods -w
kubectl config view --minify
Affiche les informations liées au contexte actif, pour vérifier la configuration retenue.
Exemple
kubectl config view --minify
Attention : certaines sorties de configuration peuvent contenir des informations sensibles.