跳至主要内容

建立和修訂 RKE 範本

RKE1 生命週期結束

RKE1 已達到生命週期結束且不再受支援。對於新的部署,請使用 RKE2 或 K3s。

本節說明如何管理 RKE 範本和修訂版本。您可以從叢集管理視圖的 RKE1 設定 > RKE 範本下建立、共享、更新和刪除範本。

範本更新是透過修訂版本系統處理的。當範本擁有者想要變更或更新範本時,他們會建立範本的新修訂版本。個別修訂版本無法編輯。但是,如果您想要防止修訂版本用於建立新叢集,您可以停用它。

範本修訂版本可以透過兩種方式使用:建立新叢集,或升級使用範本早期版本建立的叢集。範本建立者可以選擇預設修訂版本,但當最終使用者建立叢集時,他們可以選擇任何可用的範本和任何範本修訂版本。在從特定修訂版本建立叢集後,它無法變更到另一個範本,但叢集可以升級到同一範本的較新可用修訂版本。

範本擁有者對範本修訂版本擁有完全控制權,可以建立新修訂版本來更新範本、刪除或停用不應用於建立叢集的修訂版本,以及選擇哪個範本修訂版本是預設版本。

先決條件​

如果您擁有建立 RKE 範本權限,您可以建立 RKE 範本,此權限可以由管理員授予。

如果您是範本的擁有者,您可以修訂、共享和刪除範本。有關如何成為範本擁有者的詳細資訊,請參閱關於共享範本所有權的文件。

建立範本​

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 點擊 RKE1 設定 > 節點範本。
  3. 點擊新增範本。
  4. 為範本提供名稱。範本的第一個版本已經提供了一個自動生成的名稱,該版本與此範本一起建立。
  5. 可選:透過將使用者或群組新增為成員與其他使用者或群組共享範本。您還可以將範本設為公開,以便與 Rancher 設定中的每個人共享。
  6. 然後按照螢幕上的表單將叢集配置參數儲存為範本修訂版本的一部分。修訂版本可以標記為此範本的預設版本。

結果: 已配置具有一個修訂版本的 RKE 範本。您稍後可以在佈建 Rancher 啟動的叢集時使用此 RKE 範本修訂版本。叢集由 RKE 範本管理後,它無法中斷連接,且取消勾選使用現有的 RKE 範本和修訂版本的選項將不可用。

更新範本​

當您更新 RKE 範本時,您是在建立現有範本的修訂版本。使用範本較舊版本建立的叢集可以更新以符合新修訂版本。

您無法編輯個別修訂版本。由於您無法編輯範本的個別修訂版本,為了防止修訂版本被使用,您可以停用它。

建立新範本修訂版本時,使用範本較舊修訂版本的叢集不受影響。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在左側導覽選單中,點擊 RKE1 設定 > RKE 範本。
  3. 前往您想要編輯的範本並點擊 ⋮ > 編輯。
  4. 編輯所需的資訊並點擊儲存。
  5. 可選:您可以變更此範本的預設修訂版本,也可以變更與誰共享它。

結果: 範本已更新。要將其套用到使用範本較舊版本的叢集,請參閱將叢集升級到使用範本的新修訂版本一節。

刪除範本​

當您不再為任何叢集使用 RKE 範本時,您可以刪除它。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 點擊 RKE1 設定 > RKE 範本。
  3. 前往您想要刪除的 RKE 範本並點擊 ⋮ > 刪除。
  4. 確認刪除。

結果: 範本已刪除。

基於預設修訂版本建立修訂版本​

您可以複製預設範本修訂版本並快速更新其設定,而不是從頭開始建立新修訂版本。複製範本可以節省您重新輸入存取金鑰和建立叢集所需的其他參數的麻煩。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在左側導覽選單中,點擊 RKE1 設定 > RKE 範本。
  3. 前往您想要複製的 RKE 範本並點擊 ⋮ > 從預設建立新修訂版本。
  4. 完成表單的其餘部分以建立新修訂版本。

結果: RKE 範本修訂版本已複製並配置。

基於複製的修訂版本建立修訂版本​

當從您的使用者設定建立新的 RKE 範本修訂版本時,您可以複製現有修訂版本並快速更新其設定,而不是從頭開始建立新修訂版本。複製範本修訂版本可以節省您重新輸入叢集參數的麻煩。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在 RKE1 設定下,點擊 RKE 範本。
  3. 前往您想要複製的範本修訂版本。然後選擇 ⋮ > 複製修訂版本。
  4. 完成表單的其餘部分。

結果: RKE 範本修訂版本已複製並配置。您稍後可以在佈建叢集時使用 RKE 範本修訂版本。任何使用此 RKE 範本的現有叢集都可以升級到此新修訂版本。

停用範本修訂版本​

當您不再希望 RKE 範本修訂版本用於建立新叢集時,您可以停用它。已停用的修訂版本可以重新啟用。

如果修訂版本未被任何叢集使用,您可以停用它。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在左側導覽選單中,點擊 RKE1 設定 > RKE 範本。
  3. 前往您想要停用的範本修訂版本。然後選擇 ⋮ > 停用。

結果: RKE 範本修訂版本無法用於建立新叢集。

重新啟用已停用的範本修訂版本​

如果您決定應該使用已停用的 RKE 範本修訂版本來建立新叢集,您可以重新啟用它。

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在 RKE1 設定下,點擊 RKE 範本。
  3. 前往您想要重新啟用的範本修訂版本。然後選擇 ⋮ > 啟用。

結果: RKE 範本修訂版本可以用於建立新叢集。

將範本修訂版本設定為預設​

當最終使用者使用 RKE 範本建立叢集時,他們可以選擇使用哪個修訂版本建立叢集。您可以配置預設使用哪個修訂版本。

要將 RKE 範本修訂版本設定為預設,

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在左側導覽選單中,點擊 RKE1 設定 > RKE 範本。
  3. 前往應該作為預設的 RKE 範本修訂版本並點擊 ⋮ > 設定為預設。

結果: 當使用範本建立叢集時,RKE 範本修訂版本將作為預設選項使用。

刪除範本修訂版本​

您可以刪除範本的所有修訂版本,但預設修訂版本除外。

要永久刪除修訂版本,

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 在左側導覽選單中,點擊 RKE1 設定 > RKE 範本。
  3. 前往應該刪除的 RKE 範本修訂版本並點擊 ⋮ > 刪除。

結果: RKE 範本修訂版本已刪除。

將叢集升級到使用新的範本修訂版本​

備註

本節假設您已經有一個已套用 RKE 範本的叢集。

本節還假設您已更新叢集正在使用的範本,以便新的範本修訂版本可用。

要將叢集升級到使用新的範本修訂版本,

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 前往您想要升級的叢集並點擊 ⋮ > 編輯設定。
  3. 在叢集選項部分,點擊範本修訂版本的下拉選單,然後選擇新的範本修訂版本。
  4. 點擊儲存。

結果: 叢集已升級以使用新範本修訂版本中定義的設定。

將執行中的叢集匯出到新的 RKE 範本和修訂版本​

您可以將現有叢集的設定儲存為 RKE 範本。

這會將叢集的設定匯出為新的 RKE 範本,並將叢集繫結到該範本。結果是只有在範本更新且叢集升級到使用範本的較新版本時,才能變更叢集。

要將現有叢集轉換為使用 RKE 範本,

  1. 在左上角,點擊 ☰ > 叢集管理。
  2. 前往將轉換為使用 RKE 範本的叢集並點擊 ⋮ > 儲存為 RKE 範本。
  3. 在出現的表單中輸入 RKE 範本的名稱,然後點擊建立。

結果:

  • 建立了一個新的 RKE 範本。
  • 叢集被轉換為使用新範本。
  • 可以從新範本和修訂版本建立新叢集。