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.

Cluster-Vorlagen

Cluster-Vorlagen umfassen sowohl die Kubernetes-Konfiguration als auch die Konfiguration des Knotenpools, sodass eine einzige Vorlage alle Informationen enthalten kann, die Rancher benötigt, um neue Knoten bei einem Cloud-Anbieter bereitzustellen und Kubernetes auf diesen Knoten zu installieren.

Übersicht

Cluster-Vorlagen werden als Helm-Charts bereitgestellt. Um sie zu verwenden, müssen Sie die Vorlagen klonen und forken, sie entsprechend Ihrem Anwendungsfall ändern und dann die Helm-Charts im Rancher-Management-Cluster installieren. Wenn das Helm-Chart im Rancher-Management-Cluster installiert ist, wird eine neue Cluster-Ressource erstellt, die Rancher verwendet, um den neuen Cluster bereitzustellen.

Nachdem der Cluster mit der Vorlage bereitgestellt wurde, haben Änderungen an der Vorlage keinen Einfluss auf den Cluster. Nachdem der Cluster aus der Cluster-Vorlage erstellt wurde, kann sich seine Konfiguration und Infrastruktur ändern, da keine Einschränkungen durch Cluster-Vorlagen durchgesetzt werden.

Kubernetes-Distribution

Cluster-Vorlagen können jede Kubernetes-Distribution verwenden. Im Moment bieten wir ein Beispiel mit einem RKE2-Kubernetes-Cluster an. In Zukunft könnten wir weitere Beispiele mit anderen Kubernetes-Distributionen bereitstellen.

Versionierung

Rancher verwaltet keine Versionskontrolle für Cluster-Vorlagen. Die Versionskontrolle erfolgt im Repository, das das Helm-Chart der Vorlage enthält.

SUSE® Rancher Prime: RKE2 Cluster-Vorlage

Siehe das Beispiel-Repository für eine RKE2-Cluster-Vorlage.

Hinzufügen einer Cluster-Vorlage zu Rancher

In diesem Abschnitt lernen Sie, wie Sie die Cluster-Vorlage zur Chart-Repo-Liste des local Clusters hinzufügen. Das Ergebnis ist, dass Rancher die Cluster-Vorlage als Option einbezieht, wenn Benutzer neue Kubernetes-Cluster installieren.

Voraussetzungen:

  • Sie benötigen die Berechtigung, um Helm-Charts im local Rancher-Cluster zu installieren.

  • Um das Chart im Formular zur Erstellung eines Clusters anzuzeigen, müssen sowohl das Chart als auch die index.yaml-Datei die Annotation catalog.cattle.io/type: cluster-template haben.

  1. Gehen Sie zu einem Beispiel-Repository für Cluster-Vorlagen. Die Beispiele von Rancher befinden sich in diesem GitHub-Repository.

  2. Forken Sie das Repository.

  3. Optional: Bearbeiten Sie die Cluster-Optionen, indem Sie die values.yaml-Datei bearbeiten. Für Hilfe beim Bearbeiten der Datei siehe die README des Helm-Charts der Cluster-Vorlage.

  4. Fügen Sie das Chart-Repository zu Rancher hinzu. Klicken Sie auf ☰ > Clusterverwaltung.

  5. Gehen Sie zum local Cluster und klicken Sie auf Erkunden.

  6. Klicken Sie in der linken Navigationsleiste auf Apps  Chart-Repositories.

  7. Klicken Sie auf Erstellen.

  8. Geben Sie einen Namen für das Repository der Cluster-Vorlage ein.

  9. Klicken Sie auf Git-Repository mit Helm-Chart-Definitionen.

  10. Geben Sie im Feld Git-Repo-URL die URL für das Repository ein. Beispiel: https://github.com/rancher/cluster-template-examples.git.

  11. Geben Sie im Feld Git-Branch den Branch ein, der als Quelle für die Vorlage verwendet werden soll. Das Beispiel-Repository von Rancher verwendet main.

  12. Klicken Sie auf Erstellen.

Ergebnis: Die Cluster-Vorlage ist in den Apps des Rancher-Clusters local verfügbar. Es kann jetzt verwendet werden, um Cluster bereitzustellen.

Erstellen eines Clusters aus einer Cluster-Vorlage

Voraussetzungen:

  • Sie benötigen die Berechtigung, um neue Kubernetes-Cluster bereitzustellen.

  • Sie benötigen Cloud-Anmeldeinformationen, um Infrastruktur mit der Vorlage bereitzustellen.

  • Um im Formular zur Erstellung neuer Cluster anzuzeigen, muss das Helm-Chart der Cluster-Vorlage die catalog.cattle.io/type: cluster-template Annotation haben.

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Klicken Sie auf der Cluster Seite auf Erstellen.

  3. Klicken Sie auf den Namen Ihrer Cluster-Vorlage.

  4. Schließen Sie die Installation des Helm-Charts ab.

Ergebnis: Nachdem Rancher den neuen Cluster bereitgestellt hat, wird er auf die gleiche Weise verwaltet wie jeder andere von Rancher gestartete Kubernetes-Cluster. Sie können alle Optionen über die Benutzeroberfläche konfigurieren, wenn die Cluster-Vorlage Optionen zur Auswahl für den Benutzer hat.

Aktualisierung eines Clusters, das aus einer Cluster-Vorlage erstellt wurde

Sie können alle Cluster aktualisieren, die eine Vorlage von der Apps  Installierte Apps Seite verwenden, sofern es eine neue Version einer Vorlage gibt, die von diesen Clustern verwendet wird.

Bereitstellung von Clustern aus einer Vorlage mit SUSE® Rancher Prime: Continuous Delivery

Voraussetzungen:

  • Sie benötigen die Berechtigung, um neue Kubernetes-Cluster bereitzustellen.

  • Sie benötigen Cloud-Anmeldeinformationen, um Infrastruktur mit der Vorlage bereitzustellen.

  • Um im Formular zur Erstellung neuer Cluster anzuzeigen, muss das Helm-Chart der Cluster-Vorlage die catalog.cattle.io/type:cluster-template Annotation haben.

  • Um eine Vorlage im Rahmen von Continuous Delivery/GitOps zu verwenden, muss die Cluster-Vorlage im fleet-local Namespace des local Clusters bereitgestellt werden.

  • Alle Werte müssen im values.yaml der Vorlage festgelegt werden.

  • Fleet-Repositories müssen diesen Richtlinien folgen. Für RKE2-Cluster-Vorlagen bedeutet das, dass eine fleet.yaml-Datei zum Repository hinzugefügt werden muss.

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Klicken Sie auf der Cluster Seite auf Erstellen.

  3. Klicken Sie auf Cluster aus Vorlage erstellen.

Ergebnis: Nachdem Rancher den neuen Cluster bereitgestellt hat, wird er von Fleet verwaltet.

Deinstallation von Cluster-Vorlagen

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Gehen Sie zum local Cluster und klicken Sie auf Apps  Chart-Repositories.

  3. Gehen Sie zum Chart-Repository Ihrer Cluster-Vorlage und klicken Sie auf ⋮ > Löschen.

  4. Bestätigen Sie den Löschvorgang.

Ergebnis: Die Cluster-Vorlage wird deinstalliert. Diese Aktion hat keine Auswirkungen auf Cluster, die mit der Cluster-Vorlage erstellt wurden.

Ein Administrator mit Zugriff auf den local Cluster kann auch einen über Cluster-Vorlagen bereitgestellten Cluster über die Apps  Installierte Apps Seite entfernen.

Konfigurationsoptionen

Cluster-Vorlagen sind flexibel genug, um alle der folgenden Optionen zu konfigurieren:

  • Knotenkonfiguration

  • Knotenpools

  • Vordefinierte Cloud-Anmeldeinformationen

  • Aktivieren/konfigurieren Sie einen autorisierten Cluster-Endpunkt, um kubectl-Zugriff auf den Cluster zu erhalten, ohne Rancher als Proxy zu verwenden

  • Rancher V2-Überwachung installieren

  • Kubernetes-Version

  • Cluster-Mitglieder zuweisen

  • Infrastrukturkonfiguration wie AWS VPC/Subnetze oder vSphere-Rechenzentrum

  • Cloud-Anbieteroptionen

  • Pod-Sicherheitsoptionen

  • Netzwerkanbieter

  • Ingress-Controller

  • Netzwerksicherheitskonfiguration

  • Netzwerk-Plugins

  • URL und Anmeldeinformationen für private Registries

  • Add-Ons

  • Kubernetes-Optionen, einschließlich Konfigurationen für Kubernetes-Komponenten wie kube-api, kube-controller, kubelet und Dienste

Weitere Informationen zur Konfiguration der Vorlage finden Sie in der README des Helm-Charts der Cluster-Vorlage.