Kubernetes — Le cours

Guide 02 / 3

Commandes Kubernetes · kubectl

Utiliser kubectl pour observer, déployer, dépanner et administrer un cluster de formation.

Résultat attendu :

Choisir une commande, vérifier sa portée et diagnostiquer un déploiement sans intervention destructive inutile.

Lecture
0%

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.

kubectl version --client

kubectl cluster-info

Affiche les adresses des principaux services du cluster joignable.

kubectl cluster-info

kubectl config get-contexts

Liste les contextes du kubeconfig : un contexte combine cluster, identité et namespace par défaut.

kubectl config get-contexts

kubectl config current-context

Affiche le contexte actif afin d’éviter d’agir sur un mauvais environnement.

kubectl config current-context

kubectl config use-context

Change le contexte utilisé par défaut dans la configuration locale kubectl.

kubectl config use-context lab
À retenir :

Attention à ne pas basculer accidentellement en production.

kubectl get namespaces

Liste les namespaces accessibles du cluster.

kubectl get ns

kubectl config set-context --current --namespace

Fixe le namespace par défaut du contexte courant, sans changer de cluster.

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.

kubectl get pods

kubectl get -A / -n

-A cible tous les namespaces ; -n en choisit un précis pour les ressources namespacées.

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.

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.

kubectl get deployment web -o yaml
À retenir :

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.

kubectl describe pod web-abc123

kubectl get events

Montre les événements du cluster ou du namespace : échecs de placement, démarrage ou montage.

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.

kubectl api-resources

kubectl explain

Explique les champs attendus par un objet de l’API à l’aide du schéma connu du cluster.

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.

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.

kubectl diff -f ./manifests/
À retenir :

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.

kubectl apply --dry-run=server -f deployment.yaml
À retenir :

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.

kubectl create namespace dev

kubectl create deployment

Crée un Deployment depuis la ligne de commande, utile pour une démonstration rapide.

kubectl create deployment web --image=nginx:stable

kubectl edit

Ouvre l’éditeur local pour modifier un objet existant puis soumettre les modifications à l’API.

kubectl edit deployment web
À retenir :

Pour une configuration reproductible, reporter ensuite le changement dans Git.

kubectl delete

Supprime des ressources ciblées, dans le namespace ou contexte sélectionné.

kubectl delete -f deployment.yaml
À retenir :

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é.

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é.

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.

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.

kubectl port-forward svc/web 8080:80
À retenir :

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.

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.

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.

kubectl debug -it pod/web-abc --image=busybox:1.36 --target=nginx
À retenir :

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.

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.

kubectl set image deployment/web nginx=nginx:stable
À retenir :

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.

kubectl rollout status deployment/web --timeout=120s

kubectl rollout history

Affiche les révisions enregistrées pour un Deployment, si l’historique est disponible.

kubectl rollout history deployment/web

kubectl rollout undo

Demande le retour à une révision antérieure d’un Deployment.

kubectl rollout undo deployment/web
À retenir :

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.

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é.

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.

kubectl cordon worker-1

kubectl drain

Évacue les Pods concernés d’un nœud pour une maintenance, en respectant certaines protections.

kubectl drain worker-1 --ignore-daemonsets
À retenir :

À 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é.

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.

kubectl auth can-i get secrets -n dev

kubectl get pvc,pv,storageclass

Inspecte les demandes, volumes disponibles et classes de stockage.

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.

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.

kubectl get configmaps,secrets -n dev
À retenir :

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.

kubectl --context lab -n dev get pods

-l / --selector

Filtre les objets selon leurs labels ; permet de viser un sous-ensemble fonctionnel.

kubectl get pods -l app=web

-o jsonpath

Extrait des champs précis de la réponse API, utile pour scripts et automatisation.

kubectl get pod web-abc -o jsonpath="{.status.phase}"

--watch / -w

Observe en continu les modifications d’une liste de ressources.

kubectl get pods -w

kubectl config view --minify

Affiche les informations liées au contexte actif, pour vérifier la configuration retenue.

kubectl config view --minify
À retenir :

Attention : certaines sorties de configuration peuvent contenir des informations sensibles.