Se connecter

01Votre compte Rancher

Rancher est la console web de la plateforme. Votre administrateur vous a transmis un identifiant, un mot de passe provisoire et le nom de votre namespace.

1. Ouvrez https://rancher.k8s.exemple.fr et connectez-vous.
2. Changez le mot de passe tout de suite, depuis le menu de votre avatar en haut à droite.
3. Ouvrez le cluster demo : vous y voyez votre projet et votre namespace.

Tout ce que fait kubectl, l'interface sait le faire aussi : liste des pods, journaux en direct, shell dans un conteneur. C'est le bon endroit pour regarder ; la ligne de commande reste le bon endroit pour agir de façon reproductible.

02Installer kubectl

# macOS
brew install kubectl
# Windows
winget install Kubernetes.kubectl
# Linux : le paquet de votre distribution, ou le binaire officiel
curl -LO "https://dl.k8s.io/release/v1.36.5/bin/linux/amd64/kubectl"
sudo install -m 0755 kubectl /usr/local/bin/kubectl

kubectl version --client

Une version de kubectl à une version mineure près de celle du cluster convient : pour un cluster en 1.36, de 1.35 à 1.37.

03Récupérer le kubeconfig

Dans Rancher, sur le cluster demo, l'icône Download KubeConfig de la barre du haut télécharge un fichier qui contient l'adresse de la plateforme et votre jeton personnel. Rangez-le à part, plutôt que de mélanger plusieurs clusters dans un seul fichier :

mkdir -p ~/.kube
mv ~/Downloads/demo.yaml ~/.kube/captain-demo.yaml
chmod 600 ~/.kube/captain-demo.yaml

export KUBECONFIG=~/.kube/captain-demo.yaml
kubectl config set-context --current --namespace=mon-equipe
kubectl get pods          # "No resources found" : la connexion fonctionne

Ajoutez la ligne export à votre ~/.bashrc ou ~/.zshrc si la plateforme devient votre quotidien.

04Votre namespace et vos droits

Vous êtes membre d'un projet Rancher : vous gérez tout dans les namespaces de ce projet, et rien en dehors. Certaines commandes sont donc refusées, et c'est normal :

kubectl get pods,svc,ingress          # oui : votre namespace
kubectl auth can-i create deployments # yes
kubectl get nodes                     # Forbidden : les serveurs ne vous regardent pas
kubectl get pods -n kube-system       # Forbidden : le namespace d'un autre

Un quota borne aussi ce que le projet peut consommer en processeur, en mémoire et en stockage. Il ne gêne pas un usage normal ; il évite qu'une boucle infinie de votre collègue ne vous prive de place.

05Protéger vos accès

Le jeton expire au bout d'un certain temps, fixé par l'administrateur. Si kubectl répond soudain Unauthorized, il suffit de télécharger un nouveau kubeconfig.