跳至主要内容

叢集範本

叢集範本包含 Kubernetes 組態和節點集區組態，讓單一範本能包含 Rancher 在雲端提供者中佈建新節點並在這些節點上安裝 Kubernetes 所需的所有資訊。

概觀​

叢集範本以 Helm chart 的形式提供。若要使用它們，您需要複製並分支範本，根據您的使用案例進行變更，然後在 Rancher 管理叢集上安裝 Helm chart。當 Helm chart 安裝在 Rancher 管理叢集上時，會建立一個新的叢集資源，Rancher 使用該資源來佈建新叢集。

使用範本佈建叢集後，對範本的任何變更都不會影響該叢集。從叢集範本建立叢集後，其組態和基礎設施可以變更，因為叢集範本不會強制執行任何限制。

Kubernetes 發行版​

叢集範本可以使用任何 Kubernetes 發行版。目前，我們提供了 RKE2 Kubernetes 叢集的範例。我們未來可能會提供使用其他 Kubernetes 發行版的更多範例。

版本控制​

Rancher 不會管理叢集範本的版本控制。版本控制是在包含範本的 Helm chart 的儲存庫中處理。

RKE2 叢集範本​

請參閱 RKE2 叢集範本的範例儲存庫。

將叢集範本新增到 Rancher​

在本節中，您將學習如何將叢集範本新增到 local 叢集的 chart 儲存庫清單。結果是當使用者安裝新的 Kubernetes 叢集時，Rancher 將會包含該叢集範本作為選項。

先決條件：
  • 您需要在 local Rancher 叢集上安裝 Helm chart 的權限。
  • 若要在叢集建立表單中顯示 chart，chart 和 index.yaml 檔案都必須具有 catalog.cattle.io/type: cluster-template 註釋。
  1. 前往叢集範本範例儲存庫。Rancher 的範例位於此 GitHub 儲存庫。
  2. 分支該儲存庫。
  3. 選填：透過編輯 values.yaml 檔案來編輯叢集選項。若需要編輯檔案的協助，請參閱叢集範本的 Helm chart README。
  4. 將 chart 儲存庫新增到 Rancher。點選 ☰ > 叢集管理。
  5. 前往 local 叢集並點選探索。
  6. 在左側導覽列中，點選 Apps > Chart Repositories。
  7. 點選建立。
  8. 輸入叢集範本儲存庫的名稱。
  9. 點選 Git Repository containing Helm chart definitions。
  10. 在 Git Repo URL 欄位中，輸入儲存庫的 URL。例如，https://github.com/rancher/cluster-template-examples.git。
  11. 在 Git Branch 欄位中，輸入要用作範本來源的分支。Rancher 的範例儲存庫使用 main。
  12. 點選建立。

**結果：**叢集範本可從 Rancher 的 local 叢集中的 Apps 取得。現在可以用來部署叢集。

從叢集範本建立叢集​

先決條件：
  • 您需要佈建新 Kubernetes 叢集的權限。
  • 您需要使用範本佈建基礎設施的雲端憑證。
  • 為了在建立新叢集的表單中顯示，叢集範本的 Helm chart 必須具有 catalog.cattle.io/type: cluster-template 註釋。
  1. 點選 ☰ > 叢集管理。
  2. 在叢集頁面上，點選建立。
  3. 點選您的叢集範本名稱。
  4. 完成安裝 Helm chart。

**結果：**在 Rancher 佈建新叢集後，它的管理方式與任何其他 Rancher 啟動的 Kubernetes 叢集相同。如果叢集範本有供使用者選擇的選項，您可以透過 UI 設定任何選項。

更新從叢集範本建立的叢集​

您可以從 Apps > Installed Apps 頁面更新使用範本的任何叢集，前提是這些叢集所使用的範本有新版本。

使用 Fleet 從範本部署叢集​

先決條件：
  • 您需要佈建新 Kubernetes 叢集的權限。
  • 您需要使用範本佈建基礎設施的雲端憑證。
  • 為了在建立新叢集的表單中顯示，叢集範本的 Helm chart 必須具有 catalog.cattle.io/type:cluster-template 註釋。
  • 為了使用範本作為持續交付/GitOps 的一部分，叢集範本需要部署在 local 叢集的 fleet-local 命名空間中。
  • 所有值都必須在範本的 values.yaml 中設定。
  • Fleet 儲存庫必須遵循這些指南。對於 RKE2 叢集範本，這意味著必須將 fleet.yaml 檔案新增到儲存庫。
  1. 點選 ☰ > 叢集管理。
  2. 在叢集頁面上，點選建立。
  3. 點選從範本建立叢集。

**結果：**在 Rancher 佈建新叢集後，它由 Fleet 管理。

解除安裝叢集範本​

  1. 點選 ☰ > 叢集管理。
  2. 前往 local 叢集並點選 Apps > Chart Repositories。
  3. 前往您的叢集範本的 chart 儲存庫並點選 ⋮ > 刪除。
  4. 確認刪除。

**結果：**叢集範本已解除安裝。此操作不會影響使用該叢集範本建立的叢集。

具有 local 叢集存取權限的管理員也可以透過 Apps > Installed Apps 頁面移除透過叢集範本部署的叢集。

組態選項​

叢集範本足夠靈活，可用於設定以下所有選項：

  • 節點組態
  • 節點集區
  • 預先指定的雲端憑證
  • 啟用/設定授權的叢集端點，以在不使用 Rancher 作為代理的情況下取得 kubectl 對叢集的存取權
  • 安裝 Rancher V2 監控
  • Kubernetes 版本
  • 指派叢集成員
  • 基礎設施組態，例如 AWS VPC/子網路或 vSphere 資料中心
  • 雲端提供者選項
  • Pod 安全選項
  • 網路提供者
  • Ingress 控制器
  • 網路安全組態
  • 網路外掛
  • 私有登錄檔 URL 和憑證
  • 附加元件
  • Kubernetes 選項，包括 Kubernetes 元件的組態，例如 kube-api、kube-controller、kubelet 和服務

有關如何設定範本的詳細資訊，請參閱叢集範本的 Helm chart README。