Dieses Dokument wurde mithilfe automatisierter maschineller Übersetzungstechnologie übersetzt. Wir bemühen uns um korrekte Übersetzungen, übernehmen jedoch keine Gewähr für die Vollständigkeit, Richtigkeit oder Zuverlässigkeit der übersetzten Inhalte. Im Falle von Abweichungen ist die englische Originalversion maßgebend und stellt den verbindlichen Text dar.

Helm CLI Kurzanleitung

Diese Anweisungen beschreiben eine schnelle Möglichkeit, eine Proof-of-Concept Rancher-Installation einzurichten.

Diese Anweisungen setzen voraus, dass Sie über eine Linux-virtuelle Maschine verfügen, mit der Sie von Ihrem lokalen Arbeitsplatz aus kommunizieren werden. Rancher wird auf der Linux-Maschine installiert. Sie müssen die IP-Adresse dieser Maschine abrufen, damit Sie Rancher von Ihrem lokalen Arbeitsplatz aus erreichen können. Rancher ist so konzipiert, dass es Kubernetes-Cluster aus der Ferne verwaltet, daher muss auch jeder Kubernetes-Cluster, den Rancher in Zukunft verwaltet, in der Lage sein, diese IP-Adresse zu erreichen.

Wir empfehlen nicht, Rancher lokal zu installieren, da dies ein Netzwerkproblem verursacht. Die Installation von Rancher auf localhost ermöglicht es nicht, mit nachgelagerten Kubernetes-Clustern zu kommunizieren, sodass Sie auf localhost die Clusterbereitstellung oder die Clusterverwaltungsfunktionen von Rancher nicht testen können.

Ihre Linux-Maschine kann überall sein. Es könnte sich um eine Amazon EC2-Instanz, einen Digital Ocean-Droplet oder eine Azure-virtuelle Maschine handeln, um nur einige Beispiele zu nennen. Andere Rancher-Dokumente verwenden oft 'Node' als allgemeinen Begriff für all diese. Eine mögliche Möglichkeit, eine Linux-Maschine bereitzustellen, besteht darin, eine Amazon EC2-Instanz einzurichten, wie in diesem Tutorial gezeigt.

Die vollständigen Installationsanforderungen finden Sie hier.

Installieren Sie SUSE® Rancher Prime: K3s auf Linux

Rancher muss auf einer unterstützten Kubernetes-Version installiert werden. Um herauszufinden, welche Kubernetes-Versionen für Ihre Rancher-Version unterstützt werden, konsultieren Sie die Rancher Support Matrix.

Um die K3s (Kubernetes)-Version anzugeben, verwenden Sie die Umgebungsvariable INSTALL_K3S_VERSION (z. B. INSTALL_K3S_VERSION="v1.24.10+k3s1"), wenn Sie das K3s-Installationsskript ausführen.

Installieren Sie einen K3s-Cluster, indem Sie diesen Befehl auf der Linux-Maschine ausführen:

curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=<VERSION> sh -s - server --cluster-init

Die Verwendung von --cluster-init ermöglicht es K3s, das eingebettete etcd als Datenspeicher zu verwenden und in ein Setup mit hoher Verfügbarkeit überzugehen. Verweisen Sie auf hohe Verfügbarkeit mit eingebetteter DB.

Speichern Sie die IP der Linux-Maschine.

Speichern Sie die kubeconfig auf Ihrem lokalen Arbeitsplatz.

Die kubeconfig-Datei ist wichtig für den Zugriff auf den Kubernetes-Cluster. Kopieren Sie die Datei unter /etc/rancher/k3s/k3s.yaml von der Linux-Maschine und speichern Sie sie auf Ihrem lokalen Arbeitsplatz im Verzeichnis ~/.kube/config. Eine Möglichkeit, dies zu tun, besteht darin, das scp-Tool zu verwenden und diesen Befehl auf Ihrem lokalen Arbeitsplatz auszuführen:

  • Mac und Linux

  • Windows

scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml ~/.kube/config

In einigen Fällen muss sichergestellt werden, dass Ihre Shell die Umgebungsvariable KUBECONFIG=~/.kube/config definiert hat, zum Beispiel kann sie in Ihren Profil- oder rc-Dateien exportiert werden.

Standardmäßig ist "scp" kein anerkannter Befehl, daher müssen wir zuerst ein Modul installieren.

In Windows Powershell:

Find-Module Posh-SSH
Install-Module Posh-SSH

## Get the remote kubeconfig file
scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml $env:USERPROFILE\.kube\config

Bearbeiten Sie die Rancher-Server-URL in der kubeconfig.

In der kubeconfig-Datei müssen Sie den Wert des Feldes server auf <IP_OF_LINUX_NODE>:6443 ändern. Der Kubernetes API-Server wird über Port 6443 erreicht, während der Rancher-Server über die Ports 80 und 443 erreicht wird. Diese Bearbeitung ist erforderlich, damit Sie beim Ausführen von Helm- oder kubectl-Befehlen von Ihrem lokalen Arbeitsplatz aus mit dem Kubernetes-Cluster kommunizieren können, auf dem Rancher installiert wird.

  • Mac und Linux

  • Windows

Eine Möglichkeit, die kubeconfig-Datei zum Bearbeiten zu öffnen, besteht darin, Vim zu verwenden:

vi ~/.kube/config

Drücken Sie i, um Vim in den Einfügemodus zu versetzen. Um Ihre Arbeit zu speichern, drücken Sie Esc. Drücken Sie dann :wq und drücken Sie Enter.

In Windows Powershell können Sie notepad.exe zum Bearbeiten der kubeconfig-Datei verwenden:

notepad.exe $env:USERPROFILE\.kube\config

Nach der Bearbeitung drücken Sie entweder ctrl+s oder gehen Sie zu File > Save, um Ihre Arbeit zu speichern.

Installieren Sie Rancher mit Helm.

Führen Sie dann von Ihrem lokalen Arbeitsplatz die folgenden Befehle aus. Sie müssen kubectl und helm installiert haben.

Um Optionen zur Anpassung der Installation des cert-managers zu sehen (einschließlich für Fälle, in denen Ihr Cluster PodSecurityPolicies verwendet), siehe die cert-manager-Dokumentation.

 
helm repo add rancher-prime <helm-chart-repo-url>

To learn more about the Rancher Prime Helm chart repository URL, see our Prime-only documentation. Authentication is required. Use your SUSE Customer Center (SCC) credentials to log in.

 
kubectl create namespace cattle-system

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/<VERSION>/cert-manager.crds.yaml

helm repo add jetstack https://charts.jetstack.io

helm repo update

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace

# Windows Powershell
helm install cert-manager jetstack/cert-manager `
  --namespace cert-manager `
  --create-namespace

Der letzte Befehl zur Installation von Rancher ist unten aufgeführt. Der Befehl benötigt einen Domainnamen, der den Datenverkehr an die Linux-Maschine weiterleitet. Um die Dinge in diesem Tutorial einfach zu halten, können Sie einen fiktiven Domainnamen verwenden, um Ihren Proof-of-Concept zu erstellen. Ein Beispiel für einen fiktiven Domainnamen wäre <IP_OF_LINUX_NODE>.sslip.io.

Um eine bestimmte Rancher-Version zu installieren, verwenden Sie das --version Flag (z. B. --version 2.6.6). Andernfalls wird standardmäßig die neueste Rancher-Version installiert.

Siehe Einrichten des Bootstrap-Passworts für die Passwortanforderungen.

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io \
  --set replicas=1 \
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

# Windows Powershell

helm install rancher rancher-prime/rancher `
  --namespace cattle-system `
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io `
  --set replicas=1 `
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

Wenn Sie jetzt zu <IP_OF_LINUX_NODE>.sslip.io in einem Webbrowser navigieren, sollten Sie die Rancher-Benutzeroberfläche sehen.

Um diese Anweisungen einfach zu gestalten, haben wir einen fiktiven Domainnamen und selbstsignierte Zertifikate verwendet, um diese Installation durchzuführen. Daher müssen Sie wahrscheinlich eine Sicherheitsausnahme in Ihrem Webbrowser hinzufügen, um die Rancher-Benutzeroberfläche zu sehen. Beachten Sie, dass Sie für Produktionsinstallationen ein Setup mit hoher Verfügbarkeit mit einem Load Balancer, einem echten Domainnamen und echten Zertifikaten benötigen würden.

Diese Anweisungen haben auch die vollständigen Installationsanforderungen und andere Installationsoptionen weggelassen. Wenn Sie Probleme mit diesen Schritten haben, beziehen Sie sich auf die vollständige Helm CLI-Installationsdokumentation.

Um neue Kubernetes-Cluster mit Ihrem neuen Rancher-Server zu starten, müssen Sie möglicherweise Cloud-Anmeldeinformationen in Rancher einrichten. Für weitere Informationen siehe Starten von Kubernetes-Clustern mit Rancher.