Contactez-nous

Installation de `kubectl` (l'outil de ligne de commande)

Suivez ce guide détaillé pour installer kubectl, l'outil CLI essentiel pour interagir avec vos clusters Kubernetes, sur votre système d'exploitation.

kubectl : votre télécommande pour Kubernetes

Avant de pouvoir piloter un cluster Kubernetes, vous avez besoin de la télécommande appropriée. Dans le monde de Kubernetes, cette télécommande est l'outil en ligne de commande kubectl. Comme nous l'avons vu précédemment, kubectl est le client principal qui vous permet d'envoyer des ordres à l'API Kubernetes pour inspecter, créer, modifier et supprimer des ressources.

Que vous gériez un petit cluster local sur votre machine ou un vaste ensemble de clusters en production dans le cloud, kubectl sera votre compagnon constant. Il est donc essentiel de l'installer correctement sur votre poste de travail. Heureusement, le processus est relativement simple et des binaires sont disponibles pour tous les principaux systèmes d'exploitation.

Ce sous-chapitre vous guidera à travers les étapes d'installation de kubectl sur Linux, macOS et Windows. Nous vous fournirons les commandes nécessaires et les méthodes recommandées pour obtenir la dernière version stable ou une version spécifique si besoin.

Installation pas à pas sur votre système d'exploitation

La méthode d'installation varie légèrement selon votre système. Choisissez la section correspondant à votre environnement. Assurez-vous d'avoir les droits nécessaires pour installer des logiciels sur votre machine et un accès à internet pour télécharger le binaire.

Sur Linux (x86-64) :
La méthode la plus courante consiste à télécharger le binaire directement via curl. Vous pouvez obtenir la dernière version stable avec la commande suivante :
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
Après le téléchargement, validez le binaire (étape recommandée mais optionnelle pour un environnement local simple), rendez-le exécutable et déplacez-le dans votre PATH :
# Optionnel : Télécharger le fichier checksum
curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
# Optionnel : Valider le binaire
echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check

# Rendre exécutable
chmod +x ./kubectl

# Déplacer dans le PATH (ex: /usr/local/bin)
sudo mv ./kubectl /usr/local/bin/kubectl
Certaines distributions Linux proposent également kubectl via leur gestionnaire de paquets (apt pour Debian/Ubuntu, yum/dnf pour Fedora/CentOS), mais la version peut ne pas être la plus récente.Sur macOS :
Comme pour Linux, vous pouvez utiliser curl pour télécharger le binaire approprié (darwin/amd64 ou darwin/arm64 pour les Mac Apple Silicon) :
# Pour Intel
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"

# Pour Apple Silicon (ARM64)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"
Validez (optionnel), rendez exécutable et déplacez dans votre PATH :
# Optionnel: valider avec le checksum correspondant à l'architecture
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
# Assurez-vous que /usr/local/bin est dans votre $PATH
sudo chown root:wheel /usr/local/bin/kubectl # Ajuster les permissions si nécessaire
Une alternative très populaire sur macOS est d'utiliser le gestionnaire de paquets Homebrew :
brew install kubectl
Homebrew gère les mises à jour pour vous (brew upgrade kubectl).Sur Windows :
Téléchargez le binaire kubectl.exe pour Windows via curl dans une invite de commandes (cmd) ou PowerShell :
# Dans PowerShell
curl.exe -LO "https://dl.k8s.io/release/$(curl.exe -L -s https://dl.k8s.io/release/stable.txt)/bin/windows/amd64/kubectl.exe"
Après le téléchargement, il est recommandé d'ajouter le répertoire contenant kubectl.exe à votre variable d'environnement PATH système ou utilisateur pour pouvoir l'appeler depuis n'importe quel emplacement. Vous pouvez le faire via les paramètres système avancés ("Variables d'environnement") ou en utilisant PowerShell (pour la session courante ou de manière persistante).
Une autre option pratique sous Windows est d'utiliser un gestionnaire de paquets comme Chocolatey :
choco install kubernetes-cli
Ou Scoop :
scoop install kubectl
Ces gestionnaires facilitent également les mises à jour.

Vérifier votre installation de kubectl

Une fois l'installation terminée et kubectl accessible depuis votre PATH, il est important de vérifier que tout fonctionne correctement. Ouvrez une nouvelle fenêtre de terminal ou invite de commandes (pour être sûr que les modifications du PATH sont prises en compte).

La commande la plus simple pour vérifier l'installation de kubectl lui-même est de demander sa version client. Tapez la commande suivante :

kubectl version --client
Si l'installation a réussi, cette commande devrait afficher des informations sur la version du client kubectl que vous venez d'installer, sans erreur.

Exemple de sortie attendue (les numéros de version peuvent varier) :

Client Version: v1.29.1
Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3
Ne vous inquiétez pas si vous voyez un message d'erreur concernant l'impossibilité de se connecter au serveur (du type "The connection to the server localhost:8080 was refused"). C'est normal à ce stade, car nous n'avons pas encore configuré de cluster. L'important est que la partie "Client Version" s'affiche correctement.

Si la commande kubectl n'est pas reconnue, vérifiez que le répertoire où vous avez placé l'exécutable est bien inclus dans votre variable d'environnement PATH et que vous avez ouvert une nouvelle session de terminal après la modification du PATH. Avec kubectl installé et vérifié, vous disposez maintenant de l'outil fondamental pour commencer à interagir avec des clusters Kubernetes.