---
title: "Kubeconfig et outillage local"
description: "Récupérer son fichier kubeconfig depuis Rancher, installer kubectl et se préparer à travailler en ligne de commande."
source_url:
  html: https://docs.blackswift.cloud/demarrer/recuperer-votre-kubeconfig/
  md: https://docs.blackswift.cloud/demarrer/recuperer-votre-kubeconfig.md
---

# Kubeconfig et outillage local

> Récupérer son fichier kubeconfig depuis Rancher, installer kubectl et se préparer à travailler en ligne de commande.

## 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`](https://kubernetes.io/fr/docs/tasks/tools/), [Lens](https://k8slens.dev/) ou [k9s](https://k9scli.io/).

:::note[Cette étape est optionnelle]
Si vous n'utilisez que l'interface [Rancher](https://rancher.fr.blackswift.cloud), 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](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.

*(capture d'écran : Localisation du bouton download kubeconfig dans Rancher)*

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

:::danger[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](https://kubernetes.io/fr/docs/tasks/tools/install-kubectl-linux/) (paquet `kubectl` disponible dans la plupart des distributions)
- **Windows** : `winget install Kubernetes.kubectl`

## Utiliser votre kubeconfig

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

```bash
# 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 :

```bash
kubectl auth whoami
kubectl get pods
```

:::caution[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 :

```bash
kubectl config view --minify | grep namespace
```
:::

Pour la liste exacte de ce que votre compte peut faire avec kubectl, consultez
[Permissions et RBAC](https://docs.blackswift.cloud/reference/permissions-et-rbac.md).

## Outils graphiques (optionnel)

Le même kubeconfig fonctionne avec [Lens](https://k8slens.dev/) et
[k9s](https://k9scli.io/) : indiquez simplement le chemin du fichier dans leur
configuration.

---

**Étape suivante** : [déployez votre première application](https://docs.blackswift.cloud/demarrer/premiere-application.md) en moins de 15 minutes.