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.

Aktivieren experimenteller Funktionen

Rancher umfasst einige Funktionen, die experimentell sind und standardmäßig deaktiviert sind. Sie möchten diese Funktionen möglicherweise aktivieren, wenn Sie beispielsweise entscheiden, dass die Vorteile der Verwendung eines nicht unterstützten Speichertyps das Risiko der Verwendung einer ungetesteten Funktion überwiegen. Funktionsflags wurden eingeführt, um Ihnen zu ermöglichen, diese Funktionen auszuprobieren, die standardmäßig nicht aktiviert sind.

Die Funktionen können auf drei Arten aktiviert werden:

Aktivieren Sie Funktionen beim Starten von Rancher. Beim Installieren von Rancher mit einer CLI können Sie ein Funktionsflag verwenden, um eine Funktion standardmäßig zu aktivieren.
Aktivieren Sie Funktionen über die Rancher-Benutzeroberfläche, indem Sie zur Einstellungen-Seite gehen.
Aktivieren Sie Funktionen mit der Rancher-API nach der Installation von Rancher.

Jede Funktion hat zwei Werte:

Einen Standardwert, der mit einem Flag oder einer Umgebungsvariable von der Befehlszeile konfiguriert werden kann
Einen festgelegten Wert, der mit der Rancher-API oder der Benutzeroberfläche konfiguriert werden kann

Wenn kein Wert festgelegt wurde, verwendet Rancher den Standardwert.

Da die API den tatsächlichen Wert festlegt und die Befehlszeile den Standardwert festlegt, bedeutet dies, dass, wenn Sie eine Funktion mit der API oder der Benutzeroberfläche aktivieren oder deaktivieren, dies jeden mit der Befehlszeile festgelegten Wert überschreibt.

Wenn Sie beispielsweise Rancher installieren, dann ein Funktionsflag mit der Rancher-API auf true setzen und dann Rancher mit einem Befehl aktualisieren, der das Funktionsflag auf false setzt, bleibt der Standardwert false, aber die Funktion bleibt aktiviert, da sie mit der Rancher-API festgelegt wurde. Wenn Sie dann den festgelegten Wert (true) mit der Rancher-API löschen und ihn auf NULL setzen, würde der Standardwert (false) wirksam werden. Siehe die Seite der Funktionsflags für weitere Informationen.

Aktivieren von Funktionen beim Starten von Rancher

Wenn Sie Rancher installieren, aktivieren Sie die gewünschte Funktion mit einem Funktionsflag. Der Befehl ist unterschiedlich, je nachdem, ob Sie Rancher auf einem einzelnen Knoten installieren oder ob Sie eine Kubernetes-Installation von Rancher durchführen.

Aktivieren von Funktionen für Kubernetes-Installationen

Werte, die über die Rancher-API festgelegt werden, überschreiben den über die Befehlszeile übergebenen Wert.

Beim Installieren von Rancher mit einem Helm-Chart verwenden Sie die --set Option. Im folgenden Beispiel werden zwei Funktionen aktiviert, indem die Namen der Funktionsflags in einer durch Kommas getrennten Liste übergeben werden:

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org \
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Aktivieren von Funktionen für Air Gap-Installationen

Um eine Air Gap-Installation von Rancher durchzuführen, fügen Sie ein Helm-Chart-Repository hinzu und laden Sie ein Helm-Chart herunter, und installieren Sie dann Rancher mit Helm.

Wenn Sie das Helm-Chart installieren, sollten Sie die Namen der Funktionsflags in einer durch Kommas getrennten Liste übergeben, wie im folgenden Beispiel:

helm install rancher ./rancher-<VERSION>.tgz \
  --namespace cattle-system
  --set hostname=<RANCHER.YOURDOMAIN.COM> \
  --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
  --set ingress.tls.source=secret \
  --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
  --set useBundledSystemChart=true # Use the packaged Rancher system charts
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Aktivieren von Funktionen für Docker-Installationen

Beim Installieren von Rancher mit Docker verwenden Sie die --features Option. Im folgenden Beispiel werden zwei Funktionen aktiviert, indem die Namen der Funktionsflags in einer durch Kommas getrennten Liste übergeben werden:

docker run -d -p 80:80 -p 443:443 \
  --restart=unless-stopped \
  rancher/rancher:rancher-latest \
  --features=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true

Aktivieren von Funktionen mit der Rancher-Benutzeroberfläche

Klicken Sie in der oberen linken Ecke auf ☰ > Globale Einstellungen.
Klicken Sie auf Funktionsflags.
Um eine Funktion zu aktivieren, gehen Sie zu der deaktivierten Funktion, die Sie aktivieren möchten, und klicken Sie auf ⋮ > Aktivieren.

Ergebnis: Die Funktion ist aktiviert.

Deaktivieren von Funktionen mit der Rancher-Benutzeroberfläche

Klicken Sie in der oberen linken Ecke auf ☰ > Globale Einstellungen.
Klicken Sie auf Funktionsflags. Sie sehen eine Liste von experimentellen Funktionen.
Um eine Funktion zu deaktivieren, gehen Sie zu der aktivierten Funktion, die Sie deaktivieren möchten, und klicken Sie auf ⋮ > Deaktivieren.

Ergebnis: Die Funktion ist deaktiviert.

Aktivierung von Funktionen mit der Rancher-API

Wechseln Sie zu <RANCHER-SERVER-URL>/v3/features.
Im data Abschnitt sehen Sie ein Array, das alle Funktionen enthält, die mit Funktionsflags aktiviert werden können. Der Name der Funktion befindet sich im id Feld. Klicken Sie auf den Namen der Funktion, die Sie aktivieren möchten.
Klicken Sie in der oberen linken Ecke des Bildschirms unter Operationen, auf Bearbeiten.
Wählen Sie im Dropdown-Menü Wert die Option Wahr aus.
Klicken Sie auf Anfrage anzeigen.
Klicken Sie auf Anfrage senden.
Wählen Sie Schließen.

Ergebnis: Die Funktion ist aktiviert.

Deaktivierung von Funktionen mit der Rancher-API

Wechseln Sie zu <RANCHER-SERVER-URL>/v3/features.
Im data Abschnitt sehen Sie ein Array, das alle Funktionen enthält, die mit Funktionsflags aktiviert werden können. Der Name der Funktion befindet sich im id Feld. Klicken Sie auf den Namen der Funktion, die Sie deaktivieren möchten.
Klicken Sie in der oberen linken Ecke des Bildschirms unter Operationen, auf Bearbeiten.
Wählen Sie im Dropdown-Menü Wert die Option Falsch aus.
Klicken Sie auf Anfrage anzeigen.
Klicken Sie auf Anfrage senden.
Wählen Sie Schließen.

Ergebnis: Die Funktion ist deaktiviert.