跳至主要内容

功能旗標

透過功能旗標,您可以試用可選或實驗性功能,並啟用正在逐步淘汰的舊版功能。

要了解更多關於功能值以及如何啟用它們的資訊,請參閱啟用實驗性功能。

備註

某些功能旗標需要重新啟動 Rancher 容器。需要重新啟動的功能會在 Rancher UI 中標記。

以下是 Rancher 中可用的功能旗標列表。如果您從先前的 Rancher 版本升級,您可能會在 Rancher UI 中看到其他旗標,例如 proxy 或 dashboard (兩者皆已停用):

  • aggregated-roletemplates: 對 RoleTemplates、ProjectRoleTemplateBindings 和 ClusterRoleTemplateBindings 使用叢集角色聚合架構。有關更多資訊,請參閱 RoleTemplate 聚合。
  • clean-stale-secrets: 從 cattle-impersonation-system 命名空間中移除陳舊的 secret。這會慢慢清理不再由模擬系統使用的舊 secret。
  • continuous-delivery: 允許將 Fleet GitOps 與 Fleet 分開停用。有關更多資訊,請參閱 Continuous Delivery。
  • fleet: v2.6 及更高版本中的 Rancher 佈建框架需要 Fleet。當您升級時,此旗標將自動啟用,即使您在較早版本的 Rancher 中停用了此旗標。有關更多資訊,請參閱 使用 Fleet 進行持續交付。
  • harvester: 管理對虛擬化管理頁面的存取,使用者可以在其中直接導航到 Harvester 叢集並存取 Harvester UI。有關更多資訊,請參閱 Harvester 整合概述。
  • imperative-api-extension: 啟用 Rancher 的 extension API server 以向 Kubernetes 註冊新的 API。此旗標預設啟用。有關更多資訊,請參閱 Extension API Server 頁面。
  • istio-virtual-service-ui: 啟用視覺介面以建立、讀取、更新和刪除 Istio virtual services 和 destination rules,這些是 Istio 流量管理功能。
  • legacy: 啟用來自 2.5.x 及更早版本的一組功能,這些功能正在慢慢被淘汰,改用更新的實作。這些是已棄用功能以及最終將提供給較新版本的功能的混合。此旗標在新的 Rancher 安裝中預設停用。如果您從先前版本的 Rancher 升級,則此旗標已啟用。
  • managed-system-upgrade-controller: 在下游匯入的 RKE2/K3s 叢集以及本地叢集 (如果它是 RKE2/K3s 叢集) 中啟用 system-upgrade-controller 應用程式的安裝。
重要:

此 managed-system-upgrade-controller 旗標僅供內部使用,並且沒有相關的 Feature CR。請謹慎使用。

要控制 Rancher 是否應管理已匯入的 RKE2/K3s 叢集的 Kubernetes 版本,建議使用 Rancher v2.11.0 或更新版本中可用的 imported-cluster-version-management 功能。

危險

如果在 Rancher v2.10.x 中停用了 managed-system-upgrade-controller 旗標,並且任何已匯入的 RKE2/K3s 叢集在 Rancher 外部進行了升級,請按照以下步驟防止意外安裝 system-upgrade-controller 應用程式,並確保 imported-cluster-version-management 功能正常運作:

  1. 將 Rancher 升級到 v2.11.0 或更新版本,如果在 v2.10.x 安裝期間設定了 Helm 值,請確保保留 managed-system-upgrade-controller=false 功能旗標。
  2. 在 Rancher 完全啟動並執行後,停用 imported-cluster-version-management 設定。您可以透過 Rancher UI 點選 ☰ > Global Settings > Settings > imported-cluster-version-management 來執行此操作,或透過 kubectl 編輯對應的 Setting.management.cattle.io/v3 自訂資源。
  3. 執行第二次 Helm 升級,這次省略 managed-system-upgrade-controller=false 功能旗標。

現在,已匯入的叢集版本管理預設停用,Rancher 不再自動在已匯入的叢集上安裝 system-upgrade-controller 應用程式。

您可以基於每個叢集啟用此功能。有關更多資訊,請參閱文件。

  • multi-cluster-management: 允許多叢集佈建和管理 Kubernetes 叢集。此旗標只能在安裝時設定。以後無法啟用或停用。
  • rke2: 啟用佈建 RKE2 叢集。此旗標預設啟用。
  • token-hashing: 啟用 token 雜湊。啟用後,現有 token 將被雜湊,所有新 token 將自動使用 SHA256 演算法雜湊。一旦 token 被雜湊,就無法撤銷。此旗標在啟用後無法停用。有關更多資訊,請參閱 API Tokens。
  • uiextension: 啟用 UI 擴充功能。此旗標預設啟用。啟用或停用此旗標會強制 Rancher pod 重新啟動。第一次將此旗標設定為 Active 時,它會建立 CRD 並啟用功能運作所需的控制器和端點。如果設定為 Disabled,它會停用前面提到的控制器和端點。將 uiextension 設定為 Disabled 對 CRD 沒有影響 -- 如果 CRD 尚不存在,它不會建立 CRD,如果 CRD 已存在,它也不會刪除 CRD。
  • unsupported-storage-drivers: 為預設未啟用的儲存提供者和佈建程式啟用類型。有關更多資訊,請參閱允許不支援的儲存驅動程式。
  • ui-sql-cache: 為 UI 表格和伺服器端分頁啟用基於 SQLite 的快取。有關更多資訊,請參閱 UI 伺服器端分頁。

下表顯示 Rancher 中某些功能旗標的可用性和預設值。標記為「GA」的功能已正式發布:

功能旗標名稱預設值狀態可用版本其他資訊
aggregated-roletemplatesDisabled實驗性v2.11.0此旗標值在安裝時鎖定,無法變更。
clean-stale-secretsActiveGAv2.10.2
continuous-deliveryActiveGAv2.6.0
external-rulesv2.7.14: Disabled, v2.8.5: Active已移除v2.7.14, v2.8.5此旗標影響外部 RoleTemplate 行為。它在 Rancher v2.9.0 及更高版本中被移除,因為該行為預設啟用。
fleetActive無法再停用v2.6.0
fleetActiveGAv2.5.0
harvesterActive實驗性v2.6.1
imperative-api-extensionActiveGAv2.11.0
legacy新安裝為 Disabled,升級為 ActiveGAv2.6.0
managed-system-upgrade-controllerActiveGAv2.10.0
rke2true實驗性v2.6.0
token-hashing新安裝為 Disabled,升級為 ActiveGAv2.6.0
uiextensionActiveGAv2.9.0
ui-sql-cacheActiveGAv2.9.0