Wie man Rancher auf einem Debian 12 Server installiert

Rancher ist eine Open-Source-Plattform zur Verwaltung von Containern, die entwickelt wurde, um die Bereitstellung, Verwaltung und Governance von Kubernetes-Clustern zu erleichtern. Im Gegensatz zu einer Kubernetes-Distribution, die Kubernetes selbst ersetzt, fungiert Rancher als Managementlösung, die über einem oder mehreren Kubernetes-Clustern sitzt und eine zentrale Plattform bietet, von der aus Administratoren ihre gesamte Container-Infrastruktur überwachen können.

In diesem Tutorial lernen Sie, wie Sie Rancher auf einem Debian 12 Server installieren. Sie installieren Rancher als einen einzelnen Knoten über Docker, der auch den Kubernetes-Einzelknoten darauf bereitstellt.

Voraussetzungen

Um mit diesem Leitfaden zu beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Debian 12 Server mit mindestens 4 GB RAM oder Speicher
• Einen Nicht-Root-Benutzer mit Administratorrechten

Docker installieren

Bevor Sie Rancher installieren, müssen Sie sicherstellen, dass Docker auf Ihrem System installiert ist. In diesem Abschnitt installieren Sie die Docker-Engine über das offizielle Docker-Repository auf dem Debian-System.

Zuerst führen Sie den folgenden Befehl aus, um Ihr Paket-Index zu aktualisieren und Pakete wie ‘ca-certificates’ und ‘curl’ zu installieren.

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

Führen Sie nun den folgenden Befehl aus, um den GPG-Schlüssel für das Docker-Repository hinzuzufügen.

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

Führen Sie als Nächstes den folgenden Befehl aus, um das Docker-Repository zu Ihrem Debian-System hinzuzufügen. Dies erkennt automatisch Ihre Debian-Version.

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

Jetzt, da Sie das Docker-Repository und den GPG-Schlüssel hinzugefügt haben, führen Sie den folgenden Befehl aus, um Ihr Paket-Index zu aktualisieren und die Docker-Engine auf Ihrem System zu installieren. In diesem Beispiel installieren Sie die Docker-Engine mit zusätzlichen Paketen wie Docker Compose und dem Docker Buildx-Plugin.

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

Geben Sie ‘Y’ ein, um mit der Installation fortzufahren.

Sobald die Installation abgeschlossen ist, überprüfen Sie den Status des Docker-Dienstes mit dem folgenden ‘systemctl’-Befehl. Sie werden sehen, dass Docker auf Ihrer Debian-Maschine läuft und aktiviert ist.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Zuletzt können Sie den ‘docker’-Befehl unten ausführen, um den ‘hello-world’-Container auszuführen.

sudo docker run hello-world

Wenn alles erfolgreich ist, erhalten Sie die folgende ‘Hello World‘-Nachricht von Docker.

Rancher installieren

Jetzt, da Docker installiert ist, sind Sie bereit, Rancher zu installieren. In diesem Abschnitt laden Sie das Rancher-Image herunter und führen dann den Rancher-Container über Docker aus. In diesem Beispiel verwenden wir die selbstsignierten Zertifikate, die automatisch vom Rancher-Container generiert werden. Wir verwenden auch die neueste Version des Rancher-Images.

Laden Sie das Rancher-Image mit dem folgenden ‘docker pull’-Befehl herunter. In diesem Beispiel verwenden wir die neueste Version von Rancher.

sudo docker pull rancher/rancher:latest

Sobald das Rancher-Image heruntergeladen ist, führen Sie den ‘docker run’-Befehl aus, um Rancher auszuführen. Damit wird der Rancher-Container im Hintergrund ausgeführt und die Ports 80 und 443 auf dem Host-Debian-Server exportiert.

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

Überprüfen Sie den Containerstatus mit dem folgenden Befehl.

sudo docker ps

Im folgenden Output sehen Sie, dass Rancher auf Port 443 läuft. Außerdem sehen Sie die Container-ID und die Namen des Containers.

Zusätzlich, wenn Sie einen Fehler haben, können Sie das Rancher-Log mit dem folgenden ‘docker’-Befehl überprüfen.

docker ps -a  
docker log container-name oder container id

Die Option ‘ps -a’ zeigt Ihnen Container, die laufen und beendet sind, und der ‘docker log’-Befehl wird verwendet, um die Protokolle des Containers zu überprüfen.

Rancher konfigurieren

An diesem Punkt läuft Rancher auf Ihrem Debian-System als Container. Für den nächsten Schritt melden Sie sich beim Rancher-Dashboard an, um den Kubernetes-Einzelknoten zu sehen, der über Ihrer Rancher-Installation läuft.

Öffnen Sie den Webbrowser und besuchen Sie die IP-Adresse Ihres Debian-Servers, gefolgt von Port 8080, z. B. https://192.168.10.41:8080/. Wenn Ihre Installation erfolgreich ist, erhalten Sie die folgende Rancher-Anmeldeseite.

Gehen Sie zurück zu Ihrem Terminal und führen Sie den folgenden Befehl aus, um das Rancher-Passwort zu erhalten. Stellen Sie sicher, dass Sie die Container-ID mit Ihrer Installation ändern und Ihr Passwort kopieren.

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

Geben Sie nun Ihr Passwort ein und klicken Sie auf Mit lokalem Benutzer anmelden.

Kopieren Sie als Nächstes das generierte Passwort für Ihr Rancher und stellen Sie sicher, dass Sie die Bedingungen und die Lizenz akzeptieren.

Jetzt sehen Sie das folgende Rancher-Dashboard. Im folgenden Beispiel sehen Sie den mit K3s erstellten Einzelknoten-Kubernetes-Cluster.

Klicken Sie auf den lokalen Kubernetes-Cluster, und Sie erhalten weitere Informationen über Ihren Kubernetes-Cluster.

Zugriff auf den Kubernetes-Cluster mit kubectl

Laden Sie zuerst die KubeConfig auf Ihren lokalen Computer herunter. Klicken Sie im Rancher-Dashboard auf das Dateimenü unten.

Installieren Sie ‘kubectl’ auf Ihrem System mit dem folgenden Befehl. Auf Debian 12 können Sie das Paket ‘kubernetes-client‘ über APT installieren.

sudo apt install kubernetes-client -y

Setzen Sie die Standard-KUBECONFIG auf Ihre Datei. In diesem Beispiel ist die KubeConfig-Datei ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Führen Sie schließlich den ‘kubectl’-Befehl unten aus, um die Pods in allen Kubernetes-Namensräumen aufzulisten.

kubectl get pods --all-namespaces

Sie werden sehen, dass jeder Pod für den Kubernetes-Cluster unter Rancher läuft.

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Rancher mit Docker auf dem Debian 12 Server abgeschlossen. Sie haben gelernt, wie man Rancher einrichtet und einen Kubernetes-Cluster darauf erstellt. Schließlich haben Sie auch gelernt, wie man mit Ihrem Kubernetes-Cluster über den Kubernetes-Client ‘kubectl’ interagiert. Darüber hinaus können Sie Ihre containerisierten Anwendungen über ‘kubectl’ in den Kubernetes-Cluster bereitstellen.