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.

Erstellen und Überarbeiten von RKE-Vorlagen

Rancher Kubernetes Engine (RKE/RKE1) will reach end of life on July 31, 2025. Rancher 2.12.0 and later will no longer support provisioning or managing downstream RKE1 clusters. We recommend replatforming RKE1 clusters to RKE2 to ensure continued support and security updates. Learn more about the transition here.

In diesem Abschnitt wird beschrieben, wie man RKE-Vorlagen und -Revisionen verwaltet. Sie können Vorlagen aus der Cluster Management-Ansicht unter RKE1-Konfiguration  RKE-Vorlagen erstellen, teilen, aktualisieren und löschen.

Vorlagenaktualisierungen werden über ein Revisionssystem verwaltet. Wenn Vorlageninhaber eine Vorlage ändern oder aktualisieren möchten, erstellen sie eine neue Revision der Vorlage. Einzelne Revisionen können nicht bearbeitet werden. Wenn Sie jedoch verhindern möchten, dass eine Revision verwendet wird, um einen neuen Cluster zu erstellen, können Sie sie deaktivieren.

Vorlagenrevisionen können auf zwei Arten verwendet werden: um einen neuen Cluster zu erstellen oder um einen Cluster zu aktualisieren, der mit einer früheren Version der Vorlage erstellt wurde. Der Vorlageneigentümer kann eine Standardrevision wählen, aber wenn Endbenutzer einen Cluster erstellen, können sie jede Vorlage und jede Vorlagenrevision wählen, die ihnen zur Verfügung steht. Nachdem der Cluster aus einer bestimmten Revision erstellt wurde, kann er nicht zu einer anderen Vorlage wechseln, aber der Cluster kann auf eine neuere verfügbare Revision derselben Vorlage aktualisiert werden.

Der Vorlageneigentümer hat die volle Kontrolle über Vorlagenrevisionen und kann neue Revisionen erstellen, um die Vorlage zu aktualisieren, Revisionen löschen oder deaktivieren, die nicht zur Erstellung von Clustern verwendet werden sollen, und wählen, welche Vorlagenrevision die Standardrevision ist.

Voraussetzungen

Sie können RKE-Vorlagen erstellen, wenn Sie die Berechtigung RKE-Vorlagen erstellen haben, die von einem Administrator vergeben werden kann.

Sie können eine Vorlage überarbeiten, teilen und löschen, wenn Sie der Eigentümer der Vorlage sind. Für Details, wie Sie Eigentümer einer Vorlage werden können, siehe die Dokumentation zum Teilen des Vorlageneigentums.

Erstellen von Vorlagen

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie auf RKE1-Konfiguration  Knoten-Vorlagen.

  3. Klicken Sie auf Vorlage hinzufügen.

  4. Legen Sie einen Namen für die Vorlage fest. Ein automatisch generierter Name wird bereits für die erste Version der Vorlage bereitgestellt, die zusammen mit dieser Vorlage erstellt wird.

  5. Optional: Teilen Sie die Vorlage mit anderen Benutzern oder Gruppen, indem Sie sie als Mitglieder hinzufügen. Sie können die Vorlage auch öffentlich machen, um sie mit allen im Rancher-Setup zu teilen.

  6. Füllen Sie dann das auf dem Bildschirm angezeigte Formular aus, um die Cluster-Konfigurationsparameter als Teil der Revision der Vorlage zu speichern. Die Revision kann als Standard für diese Vorlage markiert werden.

Ergebnis: Eine RKE-Vorlage mit einer Revision ist konfiguriert. Sie können diese RKE-Vorlagenrevision später verwenden, wenn Sie einen von Rancher gestarteten Cluster bereitstellen. Nachdem ein Cluster von einer RKE-Vorlage verwaltet wird, kann es nicht getrennt werden, und die Option, Eine vorhandene RKE-Vorlage und Revision verwenden abzuwählen, ist nicht verfügbar.

Aktualisieren einer Vorlage

Wenn Sie eine RKE-Vorlage aktualisieren, erstellen Sie eine Revision der vorhandenen Vorlage. Cluster, die mit einer älteren Version der Vorlage erstellt wurden, können aktualisiert werden, um der neuen Revision zu entsprechen.

Sie können einzelne Revisionen nicht bearbeiten. Da Sie einzelne Revisionen einer Vorlage nicht bearbeiten können, können Sie, um zu verhindern, dass eine Revision verwendet wird, sie deaktivieren.

Wenn neue Vorlagenrevisionen erstellt werden, sind Cluster, die eine ältere Revision der Vorlage verwenden, nicht betroffen.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie im linken Navigationsmenü auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der Vorlage, die Sie bearbeiten möchten, und klicken Sie auf ⋮ > Bearbeiten.

  4. Bearbeiten Sie die erforderlichen Informationen und klicken Sie auf Speichern.

  5. Optional: Sie können die Standardrevision dieser Vorlage ändern und auch ändern, mit wem sie geteilt wird.

Ergebnis: Die Vorlage wurde aktualisiert. Um sie auf einem Cluster anzuwenden, das eine ältere Version der Vorlage verwendet, beziehen Sie sich auf den Abschnitt über das Upgrade eines Clusters zur Verwendung einer neuen Revision einer Vorlage.

Löschen einer Vorlage

Wenn Sie eine RKE-Vorlage für keines Ihrer Cluster mehr verwenden, können Sie sie löschen.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Vorlage, die Sie löschen möchten, und klicken Sie auf ⋮ > Löschen.

  4. Bestätigen Sie den Löschvorgang.

Ergebnis: Die Vorlage wird gelöscht.

Erstellen einer Revision basierend auf der Standardrevision

Sie können die Standardvorlagenrevision klonen und deren Einstellungen schnell aktualisieren, anstatt eine neue Revision von Grund auf zu erstellen. Das Klonen von Vorlagen erspart Ihnen die Mühe, die Zugangsschlüssel und andere für die Clustererstellung benötigte Parameter erneut einzugeben.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie im linken Navigationsmenü auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Vorlage, die Sie klonen möchten, und klicken Sie auf ⋮ > Neue Revision von Standard.

  4. Vervollständigen Sie den Rest des Formulars, um eine neue Revision zu erstellen.

Ergebnis: Die RKE-Vorlagenrevision wird geklont und konfiguriert.

Erstellen einer Revision basierend auf einer geklonten Revision

Beim Erstellen neuer RKE-Vorlagenrevisionen aus Ihren Benutzereinstellungen können Sie eine vorhandene Revision klonen und deren Einstellungen schnell aktualisieren, anstatt eine neue von Grund auf zu erstellen. Das Klonen von Vorlagenrevisionen erspart Ihnen die Mühe, die Clusterparameter erneut einzugeben.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie unter RKE1-Konfiguration auf RKE-Vorlagen.

  3. Gehen Sie zu der Vorlagenrevision, die Sie klonen möchten. Wählen Sie dann ⋮ > Revision klonen aus.

  4. Vervollständigen Sie den Rest des Formulars.

Ergebnis: Die RKE-Vorlagenrevision wird geklont und konfiguriert. Sie können die RKE-Vorlagenrevision später verwenden, wenn Sie ein Cluster bereitstellen. Jedes vorhandene Cluster, das diese RKE-Vorlage verwendet, kann auf diese neue Revision aktualisiert werden.

Deaktivieren einer Vorlagenrevision

Wenn Sie eine RKE-Vorlagenrevision nicht mehr für die Erstellung neuer Cluster verwenden möchten, können Sie sie deaktivieren. Eine deaktivierte RKE-Vorlagenrevision kann wieder aktiviert werden.

Sie können die RKE-Vorlagenrevision deaktivieren, wenn sie von keinem Cluster verwendet wird.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie im linken Navigationsmenü auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Vorlagenrevision, die Sie deaktivieren möchten. Wählen Sie dann ⋮ > Deaktivieren aus.

Ergebnis: Die RKE-Vorlagenrevision kann nicht verwendet werden, um einen neuen Cluster zu erstellen.

Eine deaktivierte Vorlagenrevision wieder aktivieren

Wenn Sie entscheiden, dass eine deaktivierte RKE-Vorlagenrevision verwendet werden soll, um neue Cluster zu erstellen, können Sie sie wieder aktivieren.

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie unter RKE1-Konfiguration auf RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Vorlagenrevision, die Sie wieder aktivieren möchten. Wählen Sie dann ⋮ > Aktivieren aus.

Ergebnis: Die RKE-Vorlagenrevision kann verwendet werden, um einen neuen Cluster zu erstellen.

Eine Vorlagenrevision als Standard festlegen

Wenn Endbenutzer einen Cluster mit einer RKE-Vorlage erstellen, können sie wählen, mit welcher Revision der Cluster erstellt werden soll. Sie können konfigurieren, welche Revision standardmäßig verwendet wird.

Um eine RKE-Template-Revision als Standard festzulegen,

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie im linken Navigationsmenü auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Template-Revision, die als Standard festgelegt werden soll, und klicken Sie auf ⋮ > Als Standard festlegen.

Ergebnis: Die RKE-Template-Revision wird als Standardoption verwendet, wenn Cluster mit der Vorlage erstellt werden.

Eine Vorlagenrevision löschen

Sie können alle Revisionen einer Vorlage löschen, außer der Standardrevision.

Um eine Template-Revision endgültig zu löschen,

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Klicken Sie im linken Navigationsmenü auf RKE1-Konfiguration  RKE-Vorlagen.

  3. Gehen Sie zu der RKE-Template-Revision, die gelöscht werden soll, und klicken Sie auf ⋮ > Löschen.

Ergebnis: Die RKE-Vorlagenrevision wird gelöscht.

Einen Cluster auf eine neue Vorlagenrevision aktualisieren

Dieser Abschnitt geht davon aus, dass Sie bereits einen Cluster haben, der eine RKE-Vorlage angewendet hat.

Dieser Abschnitt geht auch davon aus, dass Sie die Vorlage, die der Cluster verwendet, aktualisiert haben, sodass eine neue Vorlagenrevision verfügbar ist.

Um einen Cluster auf eine neue Template-Revision zu aktualisieren,

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Gehen Sie zu dem Cluster, das Sie aktualisieren möchten, und klicken Sie auf ⋮ > Konfiguration bearbeiten.

  3. Im Abschnitt Cluster-Optionen klicken Sie auf das Dropdown-Menü für die Template-Revision und wählen dann die neue Template-Revision aus.

  4. Klicken Sie auf Speichern.

Ergebnis: Der Cluster wird aktualisiert, um die in der neuen Template-Revision definierten Einstellungen zu verwenden.

Einen laufenden Cluster in eine neue RKE-Vorlage und Vorlagenrevision exportieren

Sie können die Einstellungen eines bestehenden Clusters als RKE-Vorlage speichern.

Dies exportiert die Einstellungen des Clusters als neue RKE-Vorlage und bindet den Cluster auch an diese Vorlage. Das Ergebnis ist, dass der Cluster nur geändert werden kann, wenn die Vorlage aktualisiert wird, und der Cluster auf eine neuere Version der RKE-Vorlage aktualisiert wird.

Um einen bestehenden Cluster zur Verwendung einer RKE-Vorlage zu konvertieren,

  1. Klicken Sie in der oberen linken Ecke auf ☰ > Clusterverwaltung.

  2. Gehen Sie zu dem Cluster, der zur Verwendung einer RKE-Vorlage konvertiert werden soll, und ⋮ > Als RKE-Vorlage speichern.

  3. Geben Sie einen Namen für die RKE-Vorlage in das erscheinende Formular ein und klicken Sie auf Erstellen.

Ergebnisse: