Kubeconfig et outillage local

Pourquoi récupérer un kubeconfig ?

Le fichier kubeconfig contient toutes les informations nécessaires pour s’authentifier et interagir avec votre cluster. Il est uniquement nécessaire si vous souhaitez accéder à votre cluster Kubernetes depuis des outils externes comme kubectl, Lens ou k9s.

Cette étape est optionnelle

Si vous n’utilisez que l’interface Rancher, vous n’avez pas besoin de télécharger le kubeconfig car l’authentification est déjà gérée.

Récupérer son kubeconfig depuis Rancher

1. Connectez-vous à l’interface Rancher : https://rancher.fr.blackswift.cloud
2. Sélectionnez le cluster auquel vous souhaitez accéder dans le menu de gauche.
3. Cliquez sur le bouton “Download Kubeconfig” en haut à droite de la page.

4. Un fichier kubeconfig.yaml sera téléchargé sur votre ordinateur.

Sécurité

Votre fichier kubeconfig contient des informations sensibles (tokens d’accès). Ne le partagez jamais et stockez-le dans un endroit sûr.

Installer kubectl

kubectl est l’outil en ligne de commande officiel de Kubernetes. Installation :

• macOS : brew install kubectl
• Linux : suivez la documentation officielle (paquet kubectl disponible dans la plupart des distributions)
• Windows : winget install Kubernetes.kubectl

Utiliser votre kubeconfig

Indiquez à kubectl où trouver votre fichier, au choix :

# Pour la session de terminal en cours
export KUBECONFIG=~/Téléchargements/kubeconfig.yaml
kubectl get pods

# Ou ponctuellement, commande par commande
kubectl --kubeconfig ~/Téléchargements/kubeconfig.yaml get pods

# Ou de façon permanente (emplacement par défaut de kubectl)
mv ~/Téléchargements/kubeconfig.yaml ~/.kube/config

Vérifiez que tout fonctionne :

kubectl auth whoami
kubectl get pods

Le namespace par défaut

Votre kubeconfig définit un namespace par défaut : toute commande lancée sans -n <namespace> s’exécute dans celui-ci. Si vous avez plusieurs environnements (dev, prod…), vérifiez toujours où vous êtes avant d’agir :

kubectl config view --minify | grep namespace

Pour la liste exacte de ce que votre compte peut faire avec kubectl, consultez Permissions et RBAC.

Outils graphiques (optionnel)

Le même kubeconfig fonctionne avec Lens et k9s : indiquez simplement le chemin du fichier dans leur configuration.

---

Étape suivante : déployez votre première application en moins de 15 minutes.