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 Charts und Apps

In diesem Abschnitt lernen Sie, wie Sie Helm-Chart-Repositories und Apps in Rancher verwalten.

Wie Helm Charts in Rancher funktionieren

Helm-Chart-Repositories in Rancher werden über Apps verwaltet.

Rancher verwendet ein katalogähnliches System, um Bündel von Charts aus Repositories zu importieren und diese Charts dann entweder zur Bereitstellung benutzerdefinierter Kubernetes-Anwendungen oder von Rancher-Tools wie Monitoring oder Istio zu verwenden. Rancher-Tools kommen als vorinstallierte Repositories, die als eigenständige Helm-Charts bereitgestellt werden. Zusätzliche Repositories werden nur zum aktuellen Cluster hinzugefügt.

Kataloge, Apps und die Rancher-Benutzeroberfläche

xref:[Rancher v2.4 und früher] wurden Repositories von einsatzbereiten Anwendungen (Anwendungen) als "Kataloge" bezeichnet. Diese Repositories wurden über den Abschnitt Kataloge der Benutzeroberfläche verwaltet.

Rancher v2.5 ersetzte das frühere Katalogsystem durch eine neue Apps & Marketplace-Funktion.

Seit Rancher v2.6.5 wird die Apps & Marketplace-Funktion in der Benutzeroberfläche als Apps bezeichnet.

Versionsschema

Das Versionsschema der Rancher-Funktionscharts konzentriert sich auf die Hauptversion der Charts und die +up Annotation für Upstream-Charts, wo zutreffend.

Hauptversion: Die Hauptversionen der Funktionscharts sind an bestimmte Nebenversionen von Rancher gebunden. Wenn Sie ein Upgrade auf eine neue Nebenversion von Rancher durchführen, sollten Sie sicherstellen, dass alle Ihre Funktionscharts ebenfalls auf die richtige Release-Linie für das Chart aktualisiert werden.

Charts basierend auf Upstream: Wenn Sie ein Upgrade durchführen, stellen Sie sicher, dass die Upstream-Chart-Version mit Ihrer Rancher-Version kompatibel ist. Die +up Annotation für das Chart zeigt an, welche Upstream-Version das Rancher-Chart verfolgt. Zum Beispiel verfolgt 100.x.x+up16.6.0 für Monitoring den upstream kube-prometheus-stack 16.6.0 mit einigen zusätzlichen Rancher-Patches.

Beim Upgrade von Rancher-Versionen sollten Sie die Version des Charts, das Sie verwenden, nicht herabstufen. Wenn Sie beispielsweise eine Version von Monitoring verwenden, die später als 16.6.0 in Rancher v2.5 ist, sollten Sie nicht auf 100.x.x+up16.6.0 upgraden. Stattdessen sollten Sie auf die entsprechende Version in der nächsten Veröffentlichung upgraden.

Prerelease-Versionen

Prereleases halten sich an die Spezifikation, die von Semantic Versioning 2.0.0 definiert ist. Zum Beispiel wird ein Helm-Chart mit einer Version von 0.1.3-dev.12ab4f als Prerelease betrachtet. Prerelease-Versionen werden standardmäßig nicht angezeigt und müssen so konfiguriert werden.

Um Prerelease-Versionen anzuzeigen:

  1. Klicken Sie auf Ihr Benutzeravatar in der oberen rechten Ecke.

  2. Klicken Sie auf Einstellungen.

  3. Unter Helm Charts wählen Sie Prerelease-Versionen einbeziehen.

Zugriff auf Charts

Die Charts-Seite enthält alle Rancher-, Partner- und benutzerdefinierten Charts. Sie können Charts filtern, indem Sie das linkeste(n) Dropdown-Menü auswählen:

  • Rancher-Tools wie Logging oder Monitoring sind unter dem Rancher-Label aufgeführt.

  • Partner-Charts sind unter dem Partners-Label aufgeführt.

  • Benutzerdefinierte Charts sind unter dem Namen ihres jeweiligen Repository aufgeführt.

Alle drei Arten von Charts werden auf die gleiche Weise bereitgestellt und verwaltet.

Apps, die vom Cluster-Manager (der globalen Ansicht in der alten Rancher-Benutzeroberfläche) verwaltet werden, werden weiterhin nur vom Cluster-Manager verwaltet, und Apps, die mit Apps in der neuen Benutzeroberfläche verwaltet werden, müssen nur von Apps verwaltet werden.

Um auf die Charts-Seite zuzugreifen:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Charts Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Charts.

Repositories verwalten

Die Repositories-Seite listet Ihre Helm-Repositories auf. Diese umfassen traditionelle Helm-Endpunkte, die ein index.yaml haben, und Git-Repositories, die geklont werden und auf einen bestimmten Branch verweisen. Um benutzerdefinierte Charts zu verwenden, fügen Sie hier Ihr Repository hinzu. Nachdem Sie ein Repository hinzugefügt haben, können Sie auf benutzerdefinierte Charts auf der Charts-Seite zugreifen, die unter dem Namen des Repository aufgeführt sind.

Um auf die Repositories-Seite zuzugreifen:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Repositories.

Benutzerdefinierte Git-Repositories hinzufügen

Um ein benutzerdefiniertes Git-Repository hinzuzufügen, das Ihre Helm-Charts oder Cluster-Vorlagendefinitionen enthält:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Repositories.

  4. Klicken Sie auf Erstellen.

  5. Wählen Sie das Ziel, Git-Repository, das Helm-Chart…​.

  6. Sie müssen einen Namen und eine Git-Repository-URL eingeben. Die anderen Felder, einschließlich der Beschreibung, sind optional. Geben Sie einen alternativen Branch-Namen ein, wenn Sie nicht von dem Branch abrufen möchten, den der Repository-Besitzer als Standard festgelegt hat. In der Regel heißt der Standard-Branch entweder main oder master.

  7. Klicken Sie Erstellen, um das Repository hinzuzufügen.

Nachdem Sie ein Chart-Repository zu Rancher hinzugefügt haben, steht es sofort zur Verfügung.

Benutzerdefinierte Helm-Chart-Repositories hinzufügen

Sie können Ihre eigenen Helm-Chart-Repositories hinzufügen, um Chart-Pakete an Rancher bereitzustellen. Sie können jeden HTTP-Server verwenden, solange der Server auf GET-Anfragen reagieren und YAML-Dateien sowie Tarball-Dateien bereitstellen kann.

Für weitere Informationen zu Helm-Chart-Repositories siehe die offiziellen Helm-Dokumente.

Um ein benutzerdefiniertes Helm-Chart-Repository zu Rancher hinzuzufügen:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Repositories.

  4. Klicken Sie auf Erstellen.

  5. Wählen Sie das Ziel, http(s) URL zu einem von Helm generierten Index.

  6. Geben Sie einen Repository-Namen und die Index-URL-Adresse des Chart-Repositories ein.

  7. Klicken Sie Erstellen, um das Repository hinzuzufügen.

Fügen Sie private Git/Helm-Chart-Repositories hinzu

Sie können private Git- oder Helm-Chart-Repositories mit SSH-Schlüssel-Anmeldeinformationen oder einem HTTP-Basic-Auth-Geheimnis, wie einem Benutzernamen und Passwort, hinzufügen.

Fügen Sie ein privates CA-Zertifikat zu Repositories hinzu

Um ein privates CA-Zertifikat zu Helm-Chart-Repositories hinzuzufügen, müssen Sie eine base64-kodierte Kopie des CA-Zertifikats im DER-Format zu dem spec.caBundle field des Chart-Repositories hinzufügen, wie openssl x509 -outform der -in ca.pem | base64 -w0. Die Anweisungen sind für Git-basierte und HTTP-basierte Repositories gleich:

  1. Klicken Sie auf ☰. Unter Cluster erkunden im linken Navigationsmenü wählen Sie einen Cluster aus.

  2. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Repositories.

  3. Suchen Sie die Zeile, die mit dem Git-basierten oder HTTP-basierten Repository verknüpft ist, zu dem Sie ein privates CA-Zertifikat hinzufügen möchten, und klicken Sie auf ⋮ > YAML bearbeiten.

  4. Setzen Sie den caBundle Wert, wie im folgenden Beispiel:

    [...]
    spec:
      caBundle:
    MIIFXzCCA0egAwIBAgIUWNy8WrvSkgNzV0zdWRP79j9cVcEwDQYJKoZIhvcNAQELBQAwPzELMAkGA1UEBhMCVVMxCzAJBgNVBAgMAkNBMRQwEgYDVQQKDAtNeU9yZywgSW5jLjENMAsGA1UEAwwEcm9vdDAeFw0yMTEyMTQwODMyMTdaFw0yNDEwMDMwODMyMT
    ...
    nDxZ/tNXt/WPJr/PgEB3hQdInDWYMg7vGO0Oz00G5kWg0sJ0ZTSoA10ZwdjIdGEeKlj1NlPyAqpQ+uDnmx6DW+zqfYtLnc/g6GuLLVPamraqN+gyU8CHwAWPNjZonFN9Vpg0PIk1I2zuOc4EHifoTAXSpnjfzfyAxCaZsnTptimlPFJJqAMj+FfDArGmr4=
    [...]
Helm-Chart-Repositories mit Authentifizierung

Die Repository.Spec enthält einen disableSameOriginCheck Wert. Dieser Wert ermöglicht es Ihnen, die Same-Origin-Prüfungen zu umgehen, indem die Authentifizierungsinformationen des Repositories als Basic Auth-Header mit allen API-Aufrufen gesendet werden. Dies wird nicht empfohlen, kann jedoch als vorübergehende Lösung in Fällen von nicht standardmäßigen Helm-Chart-Repositories verwendet werden, wie z.B. solchen, die Weiterleitungen zu einer anderen Ursprungs-URL haben.

Um diese Funktion für ein bestehendes Helm-Chart-Repository zu nutzen, folgen Sie den vorherigen Schritten bis zur Bearbeitung des YAML. Fügen Sie im spec Abschnitt der YAML-Datei disableSameOriginCheck hinzu und setzen Sie es auf true.

[...]
spec:
  disableSameOriginCheck: true
[...]

Benutzerdefinierte OCI-Chart-Repositorys hinzufügen

Helm v3 führte die Speicherung von Helm-Charts als Open Container Initiative (OCI) Artefakte in Container-Registries ein. Mit Rancher v2.9.0 können Sie OCI-basierte Helm-Chart-Repositories neben HTTP-basierten und Git-basierten Repositories hinzufügen. Das bedeutet, dass Sie Apps bereitstellen können, die als OCI-Artefakte gespeichert sind. Für weitere Informationen siehe Verwendung von OCI Helm-Chart-Repositories.

Helm-Kompatibilität

Es werden nur Helm 3-kompatible Charts unterstützt.

Chart-Repositories aktualisieren

Die Aktualisieren-Schaltfläche kann verwendet werden, um Änderungen von ausgewählten Helm-Chart-Repositories auf der Repositories-Seite zu synchronisieren.

Um ein Chart-Repository zu aktualisieren:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Repositories.

  4. Verwenden Sie den Schalter neben dem Status-Feld, um alle Repositories auszuwählen, oder schalten Sie bestimmte Chart-Repositories um, um Änderungen zu synchronisieren.

  5. Klicken Sie auf Aktualisieren.

  6. Das ⋮ am Ende jeder Zeile des Chart-Repositories enthält ebenfalls eine Aktualisieren-Option, die angeklickt werden kann, um das jeweilige Repository zu aktualisieren.

Nicht-Airgap-Rancher-Installationen spiegeln bei der Aktualisierung sofort alle Änderungen des Chart-Repositories wider, und Sie werden sehen, dass das Status-Feld für aktualisierte Repositories von In Progress auf Active wechselt, sobald die Aktion abgeschlossen ist.

Airgap-Installationen, bei denen Rancher so konfiguriert ist, dass es die verpackte Kopie der Helm-Systemcharts (useBundledSystemChart=true) verwendet, beziehen sich nur auf das system-chart Repository, das gebündelt ist, und können nicht aktualisiert oder synchronisiert werden.

Intervall für Neuanzeige

Rancher v2.10.0 fügt das refreshInterval Feld zur ClusterRepo CRD hinzu. Der Standardwert beträgt 3600 Sekunden, was bedeutet, dass Rancher jedes Helm-Repository alle 3600 Sekunden synchronisiert.

Um das Aktualisierungsintervall eines Chart-Repositories zu ändern:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Klicken Sie im linken Navigationsmenü auf dem Cluster-Dashboard auf Apps > Repositories.

  4. Suchen Sie das Repository, das Sie ändern möchten, und klicken Sie auf ⋮ > YAML bearbeiten.

  5. Setzen Sie das refreshInterval Feld unter Spec auf den gewünschten Wert in Sekunden.

  6. Klicken Sie auf Speichern.

Aktivieren/Deaktivieren von Helm-Chart-Repositories

Rancher v2.10.0 fügt die Möglichkeit hinzu, Helm-Repositories zu aktivieren und zu deaktivieren. Helm-Repositories sind standardmäßig aktiviert.

Um ein Chart-Repository zu deaktivieren:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Klicken Sie im linken Navigationsmenü auf dem Cluster-Dashboard auf Apps > Repositories.

  4. Suchen Sie das Repository, das Sie deaktivieren möchten, und klicken Sie auf ⋮ > YAML bearbeiten.

  5. Setzen Sie das Enabled Feld unter Spec auf false.

  6. Klicken Sie auf Speichern.

  7. Wenn Sie ein Repository deaktivieren, werden Updates deaktiviert und neue Änderungen am clusterRepo werden nicht angewendet.

Um ein Chart-Repository zu aktivieren:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Klicken Sie im linken Navigationsmenü auf dem Cluster-Dashboard auf Apps > Repositories.

  4. Suchen Sie das Repository, das Sie aktivieren möchten, und klicken Sie auf ⋮ > YAML bearbeiten.

  5. Setzen Sie das Enabled Feld unter Spec auf true.

  6. Klicken Sie auf Speichern.

Charts bereitstellen und aktualisieren

Um ein Chart zu installieren und bereitzustellen:

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Finden Sie den Namen des Clusters, dessen Repositories Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  3. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Charts.

  4. Wählen Sie ein Chart aus und klicken Sie auf Installieren.

Rancher- und Partner-Charts können zusätzliche Konfigurationen über benutzerdefinierte Seiten oder questions.yaml-Dateien haben. Alle Chart-Installationen können jedoch die values.yaml und andere grundlegende Einstellungen ändern. Nachdem Sie auf Installieren geklickt haben, wird ein Helm-Betriebsjob bereitgestellt, und die Konsole für den Job wird angezeigt.

Um alle aktuellen Änderungen anzuzeigen, klicken Sie auf Apps  Aktuelle Vorgänge im linken Navigationsmenü. Von dort aus können Sie die Aufrufe, Bedingungen, Ereignisse und Protokolle einsehen.

Nach der Installation eines Charts können Sie es anzeigen, indem Sie auf Apps  Installierte Apps im linken Navigationsmenü klicken. Sie können die Installation upgraden oder entfernen und weitere Details einsehen. Das Upgrade verwendet die gleichen Formulare und Werte wie bei der ursprünglichen Installation.

Die meisten Rancher-Tools haben zusätzliche Seiten in der Symbolleiste unter dem Abschnitt Apps, um die Funktionen zu verwalten und zu nutzen. Diese Seiten enthalten Links zu Dashboards, Formulare zum einfachen Hinzufügen von benutzerdefinierten Ressourcen und zusätzliche Informationen.

Wenn Sie Ihr Chart mit Helm-Optionen vor dem Upgrade anpassen upgraden und Ihr Chart unveränderliche Felder enthält, kann die Verwendung der --force-Option zu Fehlern führen. Das liegt daran, dass einige Objekte in Kubernetes nach ihrer Erstellung nicht mehr geändert werden können. Um diesen Fehler zu vermeiden:

  • Verwenden Sie die Standard-Upgrade-Option (d.h. verwenden Sie nicht --force).

  • Deinstallieren Sie das vorhandene Chart und installieren Sie das upgegradete Chart.

  • Löschen Sie die Ressourcen mit unveränderlichen Feldern aus dem Cluster, bevor Sie ein erzwungenes Upgrade durchführen.

Legacy-Apps

Die Upgrade-Schaltfläche ist für Legacy-Apps auf der Seite Apps  Installierte Apps nicht verfügbar.

Wenn Sie eine installierte Legacy-App aktualisieren möchten, muss das Legacy-Feature-Flag aktiviert sein. Dieses Flag wird automatisch aktiviert, wenn Sie bereits eine Legacy-App hatten, bevor Sie Rancher aktualisiert haben.

  1. Aktivieren Sie das Legacy-Feature-Flag, falls es noch nicht aktiviert ist.

  2. Klicken Sie auf ☰ > Clusterverwaltung.

  3. Finden Sie den Namen des Clusters, dessen Apps Sie aufrufen möchten. Klicken Sie Erforschen am Ende der Zeile des Clusters.

  4. Klicken Sie auf Legacy  Projekt  Apps.

Wenn Sie Apps nicht unter Legacy  Projekt sehen, klicken Sie auf die Suchleiste für Projekt/Namensraum in der oberen Navigation und wählen Sie das relevante Projekt aus dem Dropdown-Menü aus.

Um Legacy-Multi-Cluster-Apps zu upgraden:

  1. Klicken Sie auf ☰.

  2. Unter Legacy Apps klicken Sie auf Multi-Cluster-Apps.

Chart-spezifische Informationen

SR-IOV-Chart-Abkündigung und Migration

Das sriov (SR-IOV-Netzwerkoperator) Chart aus dem Rancher Charts Repository ist abgekündigt und wird in Rancher v2.10 entfernt. Bitte migrieren Sie stattdessen zum sriov-network-operator Chart aus dem SUSE Edge Repository (https://github.com/suse-edge/charts).

Um zu migrieren, folgen Sie diesen Schritten:

  1. Fügen Sie das SUSE Edge Repository zu Ihrem Cluster hinzu, indem Sie die Schritte in Benutzerdefinierte Git-Repositories hinzufügen befolgen.

  2. Geben Sie im Feld Git Repo URL https://github.com/suse-edge/charts ein.

  3. Klicken Sie auf Erstellen.

  4. Im linken Navigationsmenü auf dem Cluster-Dashboard klicken Sie Apps  Charts.

  5. Suchen Sie das sriov-network-operator Chart und klicken Sie darauf.

  6. Klicken Sie auf Installieren.

  7. Geben Sie im Feld Name denselben Namen ein, den Sie für Ihre bestehende sriov Chart-Installation verwendet haben.

  8. Klicken Sie auf Weiter.

  9. Klicken Sie auf Installieren.

Ergebnis: Rancher leitet zur Seite Installierte Apps weiter, wo Ihre bestehende Installation den Status Wird aktualisiert erreicht. Die Migration ist abgeschlossen, wenn der Status Bereitgestellt erreicht ist.

Nutzungsbeschränkungen

  • Dashboard-Apps oder Rancher-Funktionscharts können nicht über die Rancher Kommandozeilenschnittstelle installiert werden.

  • Bei der Bestimmung der neuesten Version, die für die Spalte Upgradefähig auf der Seite Apps  Installierte Apps angezeigt werden soll, berücksichtigt Rancher nicht nur die Versionen des Helm-Charts aus dem Repository, aus dem es installiert wurde, sondern auch die Versionen des Helm-Charts aus allen Repositories im Cluster.

    Angenommen, Sie installieren cert-manager v1.13.0 aus Repository A, wo v1.14.0 jetzt die neueste verfügbare Version ist. In diesem Fall erwarten Sie, dass Upgradefähig v1.14.0 anzeigt. Wenn der Cluster jedoch auch Zugriff auf Repository B hat, wo v1.15.0 von cert-manager verfügbar ist, zeigt Upgradefähig v1.15.0 an, obwohl die ursprüngliche Installation Repository A verwendet hat.