Comment installer Rancher sur un serveur Debian 12

Rancher est une plateforme de gestion de conteneurs open-source conçue pour faciliter le déploiement, la gestion et la gouvernance des clusters Kubernetes. Contrairement à une distribution Kubernetes qui remplace Kubernetes lui-même, Rancher agit comme une solution de gestion qui se situe au-dessus d’un ou plusieurs clusters Kubernetes, fournissant une plateforme centralisée à partir de laquelle les administrateurs peuvent superviser l’ensemble de leur infrastructure de conteneurs.

Dans ce tutoriel, vous apprendrez à installer Rancher sur un serveur Debian 12. Vous installerez Rancher en tant que nœud unique via Docker, qui déploie également le nœud unique Kubernetes au-dessus.

Prérequis

Pour commencer ce guide, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12 avec un minimum de 4 Go de RAM ou de mémoire
• Un utilisateur non-root avec des privilèges d’administrateur

Installation de Docker

Avant d’installer Rancher, vous devez vous assurer que Docker est installé sur votre système. Dans cette section, vous installerez Docker Engine via le dépôt officiel de Docker sur le système Debian.

Tout d’abord, exécutez la commande ci-dessous pour mettre à jour votre index de paquets et installer des paquets tels que ‘ca-certificates’ et ‘curl’.

sudo apt update && sudo apt install ca-certificates curl -y

Maintenant, exécutez la commande suivante pour ajouter la clé GPG pour le dépôt Docker.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

Ensuite, exécutez la commande suivante pour ajouter le dépôt Docker à votre système Debian. Cela détectera automatiquement votre version de Debian.

echo \  
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \  
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Maintenant que vous avez ajouté le dépôt Docker et la clé GPG, exécutez la commande ci-dessous pour rafraîchir votre index de paquets et installer Docker Engine sur votre système. Dans cet exemple, vous installerez Docker Engine avec des paquets supplémentaires tels que Docker Compose et le plugin Docker Buildx.

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Entrez ‘Y’ pour continuer l’installation.

Une fois l’installation terminée, vérifiez l’état du service Docker en utilisant la commande ‘systemctl’ ci-dessous. Vous verrez que Docker est en cours d’exécution et activé sur votre machine Debian.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Enfin, vous pouvez exécuter la commande ‘docker’ ci-dessous pour exécuter le conteneur ‘hello-word’.

sudo docker run hello-world

Si cela réussit, vous recevrez le message suivant ‘Hello World‘ de Docker.

Installation de Rancher

Maintenant que Docker est installé, vous êtes prêt à installer Rancher. Dans cette section, vous téléchargerez l’image Rancher, puis exécuterez le conteneur Rancher via Docker. Dans cet exemple, nous utiliserons les certificats auto-signés qui sont générés automatiquement par le conteneur Rancher. Nous utiliserons également la dernière version de l’image Rancher.

Téléchargez l’image Rancher en utilisant la commande ‘docker pull’ ci-dessous. Dans cet exemple, nous utiliserons la dernière version de Rancher.

sudo docker pull rancher/rancher:latest

Une fois l’image Rancher téléchargée, exécutez la commande ‘docker run’ pour exécuter Rancher. Avec cela, le conteneur Rancher sera en cours d’exécution en arrière-plan et exportera les ports 80 et 443 sur le serveur Debian hôte.

sudo docker run -d --restart=unless-stopped \  
-p 80:80 -p 443:443 \  
--privileged \  
rancher/rancher:latest

Vérifiez l’état du conteneur en utilisant la commande ci-dessous.

sudo docker ps

Dans la sortie ci-dessous, vous pouvez voir que Rancher fonctionne sur le port 443. De plus, vous pouvez voir l’ID du conteneur et les noms du conteneur.

De plus, si vous avez une erreur, vous pouvez vérifier le journal de Rancher avec la commande ‘docker’ suivante.

docker ps -a  
docker log nom-du-conteneur ou id du conteneur

L’option ‘ps -a’ vous montrera les conteneurs en cours d’exécution et arrêtés, et la commande ‘docker log’ est utilisée pour vérifier les journaux du conteneur.

Configuration de Rancher

À ce stade, Rancher fonctionne sur votre système Debian en tant que conteneur. Pour l’étape suivante, vous vous connecterez au tableau de bord Rancher pour voir le nœud unique Kubernetes qui fonctionne au-dessus de votre installation Rancher.

Ouvrez le navigateur web et visitez l’adresse IP de votre serveur Debian suivie du port 8080 tel que https://192.168.10.41:8080/. Si votre installation est réussie, vous obtiendrez la page de connexion Rancher suivante.

Retournez à votre terminal et exécutez la commande ci-dessous pour obtenir le mot de passe Rancher. Assurez-vous de remplacer l’ID du conteneur par votre installation et copiez votre mot de passe.

sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"

Maintenant, entrez votre mot de passe et cliquez sur Login with Local User.

Ensuite, copiez le mot de passe généré pour votre Rancher et assurez-vous d’accepter les termes et la licence.

Maintenant, vous verrez le tableau de bord Rancher suivant. Dans l’exemple ci-dessous, vous pouvez voir le cluster Kubernetes à nœud unique créé avec K3s.

Cliquez sur le cluster Kubernetes local et vous obtiendrez plus d’informations sur votre cluster Kubernetes.

Accéder au cluster Kubernetes avec kubectl

Tout d’abord, téléchargez le KubeConfig sur votre ordinateur local. Depuis le tableau de bord Rancher, cliquez sur le menu de fichiers ci-dessous.

Installez le ‘kubectl’ sur votre système avec la commande ci-dessous. Sur Debian 12, vous pouvez installer le paquet ‘kubernetes-client‘ via APT.

sudo apt install kubernetes-client -y

Définissez le KUBECONFIG par défaut sur votre fichier. Dans cet exemple, le fichier KubeConfig est ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Enfin, exécutez la commande ‘kubectl’ ci-dessous pour obtenir la liste des pods dans tous les espaces de noms Kubernetes.

kubectl get pods --all-namespaces

Vous verrez que chaque pod pour le cluster Kubernetes sous Rancher est en cours d’exécution.

Conclusion

Félicitations ! Vous avez terminé l’installation de Rancher avec Docker sur le serveur Debian 12. Vous avez appris à configurer Rancher et à créer un cluster Kubernetes au-dessus. Enfin, vous avez également appris à interagir avec votre cluster Kubernetes via le client Kubernetes ‘kubectl’. De plus, vous pouvez déployer vos applications conteneurisées sur le cluster Kubernetes via ‘kubectl’.