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.

Funktionsflags

Mit Funktionsflags können Sie optionale oder experimentelle Funktionen ausprobieren und veraltete Funktionen aktivieren, die schrittweise eingestellt werden.

Um mehr über Funktionswerte und deren Aktivierung zu erfahren, siehe Aktivierung experimenteller Funktionen.

Einige Funktionsflags erfordern einen Neustart des Rancher-Containers. Funktionen, die einen Neustart erfordern, sind in der Rancher-Benutzeroberfläche gekennzeichnet.

Die folgende Liste enthält die in Rancher verfügbaren Funktionsflags. Wenn Sie von einer vorherigen Rancher-Version aktualisiert haben, sehen Sie möglicherweise zusätzliche Flags in der Rancher-Benutzeroberfläche, wie proxy oder dashboard (beide xref:[ausgelaufen]):

  • aggregated-roletemplates: Verwenden Sie die Architektur der Clusterrollenaggregation für RoleTemplates, ProjectRoleTemplateBindings und ClusterRoleTemplateBindings. Siehe RoleTemplate-Aggregation für weitere Informationen.

  • clean-stale-secrets: Entfernt veraltete Geheimnisse aus dem cattle-impersonation-system Namespace. Dies bereinigt langsam alte Geheimnisse, die vom Identitätssystem nicht mehr verwendet werden.

  • continuous-delivery: Ermöglicht es, Fleet GitOps separat von Fleet zu deaktivieren. Siehe Continuous Delivery für weitere Informationen.

  • fleet: Das Rancher-Bereitstellungsframework in v2.6 und später erfordert Fleet. Das Flag wird automatisch aktiviert, wenn Sie ein Upgrade durchführen, auch wenn Sie dieses Flag in einer früheren Version von Rancher deaktiviert haben. Siehe Kontinuierliche Lieferung mit Fleet für weitere Informationen.

  • harvester: Verwaltet den Zugriff auf die Seite zur Virtualisierungsverwaltung, auf der Benutzer direkt zu Harvester-Clustern navigieren und auf die Harvester-Benutzeroberfläche zugreifen können. Siehe SUSE Virtualization Integrationsübersicht für weitere Informationen.

  • imperative-api-extension: Aktiviert Ranchers Erweiterungs-API-Server, um neue APIs bei Kubernetes zu registrieren. Dieses Flag ist standardmäßig aktiviert. Siehe die Seite des Erweiterungs-API-Servers für weitere Informationen.

  • istio-virtual-service-ui: Aktiviert eine grafische Benutzeroberfläche, um Istio-virtuelle Dienste und Zielregeln zu erstellen, zu lesen, zu aktualisieren und zu löschen, die Funktionen des Istio-Verkehrsmanagements sind.

  • legacy: Aktiviert eine Reihe von Funktionen aus 2.5.x und früher, die langsam zugunsten neuerer Implementierungen auslaufen. Dies sind eine Mischung aus auslaufenden Funktionen sowie Funktionen, die schließlich in neueren Versionen verfügbar sein werden. Dieses Flag ist standardmäßig bei neuen Rancher-Installationen deaktiviert. Wenn Sie von einer vorherigen Version von Rancher upgraden, ist dieses Flag aktiviert.

  • managed-system-upgrade-controller: Aktiviert die Installation der system-upgrade-controller App in nachgelagerten importierten RKE2/K3s-Clustern sowie im lokalen Cluster, wenn es sich um einen RKE2/K3s-Cluster handelt.

Dieses managed-system-upgrade-controller Flag ist nur für die interne Nutzung vorgesehen und hat kein zugehöriges Feature-CR. Gehen Sie dabei jedoch sehr sorgfältig vor.

Um zu steuern, ob Rancher die Kubernetes-Version importierter RKE2/K3s-Cluster verwalten soll, wird empfohlen, die Verwaltung der importierten Cluster-Version Funktion zu verwenden, die in Rancher v2.11.0 oder neuer verfügbar ist.

Wenn das managed-system-upgrade-controller Flag in Rancher v2.10.x deaktiviert war und irgendwelche importierten RKE2/K3s-Cluster außerhalb von Rancher aktualisiert wurden, folgen Sie den untenstehenden Schritten, um die unerwartete Installation der system-upgrade-controller App zu verhindern und sicherzustellen, dass die Verwaltung der importierten Cluster-Version Funktion korrekt funktioniert:

  1. Aktualisieren Sie Rancher auf v2.11.0 oder neuer und stellen Sie sicher, dass das Flag in den Helm-Werten beibehalten wird, wenn es während der Installation v2.10.x gesetzt wurde.

  2. Nachdem Rancher vollständig läuft, deaktivieren Sie die imported-cluster-version-management Einstellung. Sie können dies entweder über die Rancher-Benutzeroberfläche tun, indem Sie auf ☰ > Globale Einstellungen > Einstellungen > Verwaltung der importierten Cluster-Version klicken, oder indem Sie die entsprechende Setting.management.cattle.io/v3 benutzerdefinierte Ressource über kubectl bearbeiten.

  3. Führen Sie ein zweites Helm-Upgrade durch, wobei Sie diesmal das managed-system-upgrade-controller=false Feature-Flag weglassen.

Jetzt ist die Verwaltung der importierten Cluster-Version standardmäßig deaktiviert, und Rancher installiert die system-upgrade-controller App nicht mehr automatisch auf importierten Clustern.

Sie können dieses Feature auf Cluster-Basis aktivieren. Für weitere Informationen konsultieren Sie bitte die Dokumentation.

  • multi-cluster-management: Ermöglicht die Bereitstellung und Verwaltung von Kubernetes-Clustern über mehrere Cluster hinweg. Dieses Flag kann nur zur Installationszeit gesetzt werden. Es kann später nicht aktiviert oder deaktiviert werden.

  • rke2: Aktiviert die Bereitstellung von RKE2-Clustern. Dieses Flag ist standardmäßig aktiviert.

  • token-hashing: Aktiviert die Token-Hashing-Funktion. Sobald es aktiviert ist, werden bestehende Tokens gehasht und alle neuen Tokens werden automatisch mit dem SHA256-Algorithmus gehasht. Sobald ein Token gehasht ist, kann dies nicht rückgängig gemacht werden. Dieses Flag kann nach seiner Aktivierung nicht mehr deaktiviert werden. Siehe API Tokens für weitere Informationen.

  • uiextension: Aktiviert UI-Erweiterungen. Dieses Flag ist standardmäßig aktiviert. Das Aktivieren oder Deaktivieren des Flags zwingt den Rancher-Pod zum Neustart. Beim ersten Setzen dieses Flags auf Active wird ein CRD erstellt und die für das Funktionieren des Features erforderlichen Controller und Endpunkte aktiviert. Wenn auf Disabled gesetzt, werden die zuvor genannten Controller und Endpunkte deaktiviert. Das Setzen von uiextension auf Disabled hat keine Auswirkungen auf das CRD --; es wird kein CRD erstellt, wenn es noch nicht existiert, noch wird das CRD gelöscht, wenn es bereits existiert.* unsupported-storage-drivers: Aktiviert Typen für Speicheranbieter und Bereitsteller, die standardmäßig nicht aktiviert sind. Siehe Nicht unterstützte Speicher-Treiber erlauben für weitere Informationen.

  • ui-sql-cache: Aktiviert einen auf SQLite basierenden Cache für UI-Tabellen und serverseitige Paginierung. Siehe UI-Server-seitige Paginierung für weitere Informationen.

Die folgende Tabelle zeigt die Verfügbarkeit und Standardwerte für einige Funktionsflags in Rancher. Funktionen, die mit "GA" gekennzeichnet sind, sind allgemein verfügbar:

Name des Funktionsflags Standardwert Status Verfügbar seit Weitere Informationen

aggregated-roletemplates

Disabled

Experimentell

v2.11.0

Dieser Flagwert ist bei der Installation gesperrt und kann nicht geändert werden.

clean-stale-secrets

Active

GA

v2.11.0

continuous-delivery

Active

GA

v2.6.0

external-rules

v2.7.14: Disabled, v2.8.5: Active

Entfernt

v2.7.14, v2.8.5

Dieser Flag hat Auswirkungen auf externes RoleTemplate Verhalten. Es wird in Rancher v2.9.0 und später entfernt, da das Verhalten standardmäßig aktiviert ist.

fleet

Active

Kann nicht mehr deaktiviert werden

v2.6.0

fleet

Active

GA

v2.5.0

harvester

Active

Experimentell

v2.6.1

imperative-api-extension

Active

GA

v2.11.0

legacy

false für neue Installationen, true für Upgrades

GA

v2.6.0

managed-system-upgrade-controller

true

GA

v2.10.0

rke2

true

Experimentell

v2.6.0

token-hashing

Disabled für neue Installationen, Active für Upgrades

GA

v2.6.0

uiextension

Active

GA

v2.9.0

ui-sql-cache

Active

GA

v2.9.0