跳至主要内容

啟用實驗性功能

Rancher 包含一些預設停用的實驗性功能。您可能想要啟用這些功能，例如，如果您決定使用不支援的儲存類型的好處超過使用未經測試功能的風險。引入了功能旗標，讓您可以嘗試這些預設未啟用的功能。

可以透過三種方式啟用功能：

每個功能有兩個值：

  • 預設值，可以透過指令列的旗標或環境變數進行設定
  • 設定值，可以透過 Rancher API 或 UI 進行設定

如果沒有設定值，Rancher 會使用預設值。

由於 API 設定實際值，而指令列設定預設值，這意味著如果您使用 API 或 UI 啟用或停用功能，它將覆寫使用指令列設定的任何值。

例如，如果您安裝 Rancher，然後使用 Rancher API 將功能旗標設定為 true，然後使用將功能旗標設定為 false 的指令升級 Rancher，則預設值仍然是 false，但該功能仍會啟用，因為它是使用 Rancher API 設定的。如果您隨後使用 Rancher API 刪除設定值（true），將其設定為 NULL，則預設值（false）將生效。有關更多資訊，請參閱功能旗標頁面。

在啟動 Rancher 時啟用功能​

當您安裝 Rancher 時，使用功能旗標啟用您想要的功能。指令會根據您是在單一節點上安裝 Rancher 還是在 Kubernetes 上安裝 Rancher 而有所不同。

為 Kubernetes 安裝啟用功能​

備註

透過 Rancher API 設定的值將覆寫透過指令列傳入的值。

使用 Helm Chart 安裝 Rancher 時，請使用 --set 選項。在以下範例中，透過以逗號分隔的清單傳遞功能旗標名稱來啟用兩個功能：

helm install rancher rancher-latest/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'
備註

如果您要安裝 alpha 版本，Helm 需要在指令中新增 --devel 選項。

為離線安裝啟用功能​

要執行 Rancher 的離線安裝，請新增 Helm Chart 儲存庫並下載 Helm Chart，然後使用 Helm 安裝 Rancher。

在安裝 Helm Chart 時，您應該以逗號分隔的清單傳遞功能旗標名稱，如以下範例所示：

helm install rancher ./rancher-<VERSION>.tgz \
  --namespace cattle-system \
  --set hostname=<RANCHER.YOURDOMAIN.COM> \
  --set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
  --set ingress.tls.source=secret \
  --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 設定要在 Rancher 中使用的預設私有註冊表
  --set useBundledSystemChart=true # 使用打包的 Rancher 系統 Chart
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

為 Docker 安裝啟用功能​

使用 Docker 安裝 Rancher 時，請使用 --features 選項。在以下範例中，透過以逗號分隔的清單傳遞功能旗標名稱來啟用兩個功能：

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

使用 Rancher UI 啟用功能​

  1. 在左上角，點擊 ☰ > 全域設定。
  2. 點擊功能旗標。
  3. 要啟用功能，請前往您想要啟用的已停用功能並點擊 ⋮ > 啟用。

結果： 功能已啟用。

使用 Rancher UI 停用功能​

  1. 在左上角，點擊 ☰ > 全域設定。
  2. 點擊功能旗標。您將看到實驗性功能清單。
  3. 要停用功能，請前往您想要停用的已啟用功能並點擊 ⋮ > 停用。

結果： 功能已停用。

使用 Rancher API 啟用功能​

  1. 前往 <RANCHER-SERVER-URL>/v3/features。
  2. 在 data 部分，您將看到一個包含所有可以使用功能旗標開啟的功能的陣列。功能的名稱位於 id 欄位中。點擊您想要啟用的功能名稱。
  3. 在螢幕左上角的操作下，點擊編輯。
  4. 在值下拉選單中，點擊 True。
  5. 點擊顯示請求。
  6. 點擊傳送請求。
  7. 點擊關閉。

結果： 功能已啟用。

使用 Rancher API 停用功能​

  1. 前往 <RANCHER-SERVER-URL>/v3/features。
  2. 在 data 部分，您將看到一個包含所有可以使用功能旗標開啟的功能的陣列。功能的名稱位於 id 欄位中。點擊您想要啟用的功能名稱。
  3. 在螢幕左上角的操作下，點擊編輯。
  4. 在值下拉選單中，點擊 False。
  5. 點擊顯示請求。
  6. 點擊傳送請求。
  7. 點擊關閉。

結果： 功能已停用。