跳至主要内容

在現有自訂節點上啟動 Kubernetes

當您建立自訂叢集時,Rancher 可以使用 RKE2/K3s 在本地端裸機伺服器、本地端虛擬機器或由基礎設施提供者託管的任何節點中建立 Kubernetes 叢集。

要使用此選項,您需要存取將成為 Kubernetes 叢集一部分的伺服器。根據需求配置每台伺服器。然後,在每台伺服器上執行 Rancher UI 中提供的指令,將其轉換為 Kubernetes 節點。

本節說明如何設定自訂叢集。

使用自訂節點建立叢集​

想要使用 Windows 主機作為 Kubernetes 工作節點?

在開始之前,請參閱為 Windows 配置自訂叢集。

1. 配置 Linux 主機​

透過配置 Linux 主機來開始建立自訂叢集。您的主機可以是:

  • 雲端託管虛擬機器 (VM)
  • 本地端 VM
  • 裸機伺服器

如果您想要重複使用先前自訂叢集中的節點,請在叢集中再次使用它之前清理節點。如果您重複使用未清理的節點,叢集配置可能會失敗。

根據安裝需求和生產就緒叢集檢查清單配置主機。

僅限 IPv6 的叢集

對於僅限 IPv6 的叢集,請確保您的作業系統正確配置 /etc/hosts 檔案。

::1       localhost

2. 建立自訂叢集​

  1. 點擊 ☰ > Cluster Management。

  2. 在 Clusters 頁面上,點擊 Create。

  3. 點擊 Custom。

  4. 輸入 Cluster Name。

  5. 使用 Cluster Configuration 區段來設定叢集。如需更多資訊,請參閱 RKE2 叢集配置參考和 K3s 叢集配置參考。

    Windows 節點

    若要深入了解如何使用 Windows 節點作為 Kubernetes 工作節點,請參閱在 Windows 叢集上啟動 Kubernetes。

  6. 點擊 Create。

結果： UI 會重新導向到 Registration 頁面,您可以在此為節點產生註冊指令。

  1. 從 Node Role 中,選擇您希望叢集節點扮演的角色。您必須為每個角色至少配置一個節點:etcd、worker 和 control plane。自訂叢集需要這三個角色才能完成配置。如需角色的更多資訊,請參閱 Kubernetes 叢集中節點的角色。

    裸機伺服器

    如果您計劃將裸機伺服器專用於每個角色,則必須為每個角色配置一台裸機伺服器(即配置多台裸機伺服器)。

    備註

  2. 選擇性: 點擊 Show Advanced 以配置其他設定,例如指定 IP 位址、覆寫節點主機名稱或為節點新增標籤或污點

    備註

    Node Public IP 和 Node Private IP 欄位可以接受單一位址或以逗號分隔的位址清單(例如:10.0.0.5,2001:db8::1)。

    僅限 IPv6 或雙堆疊叢集

    在僅限 IPv6 和雙堆疊叢集中,您應該將節點的 IPv6 位址指定為 Node Private IP。

  3. 將畫面上顯示的指令複製到您的剪貼簿。

  4. 使用您偏好的 shell(例如 PuTTy 或遠端終端機連線)登入您的 Linux 主機。執行複製到剪貼簿的指令。

備註

如果您想要將特定主機專用於特定節點角色,請重複步驟 7-10。視需要重複這些步驟多次。

結果：

叢集已建立並轉換為 Updating 狀態,同時 Rancher 會初始化並配置叢集元件。

叢集的狀態更新為 Active 後,您就可以存取您的叢集。

Active 叢集會被分配兩個專案:

  • Default,包含 default 命名空間
  • System,包含 cattle-system、ingress-nginx、kube-public 和 kube-system 命名空間

3. 僅限 Amazon:標記資源​

如果您已將叢集配置為使用 Amazon 作為 Cloud Provider,請使用叢集 ID 標記您的 AWS 資源。

Amazon 文件:標記您的 Amazon EC2 資源

備註

您可以在不配置雲端提供者的情況下使用 Amazon EC2 執行個體。只有在您想要使用特定的 Kubernetes 雲端提供者功能時,才需要配置雲端提供者。如需更多資訊,請參閱 Kubernetes 雲端提供者

以下資源需要使用 ClusterID 進行標記:

  • Nodes:在 Rancher 中新增的所有主機。
  • Subnet:用於您的叢集的子網路
  • Security Group:用於您的叢集的安全群組。
備註

請勿標記多個安全群組。標記多個群組會在建立 Elastic Load Balancer 時產生錯誤。

應使用的標籤為:

Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned

<CLUSTERID> 可以是您選擇的任何字串。但是,您標記的每個資源都必須使用相同的字串。將標籤值設定為 owned 會通知叢集,所有使用 <CLUSTERID> 標記的資源都歸此叢集所有並由其管理。

如果您在叢集之間共用資源,可以將標籤變更為:

Key=kubernetes.io/cluster/CLUSTERID, Value=shared

選擇性後續步驟​

建立叢集後,您可以透過 Rancher UI 存取它。作為最佳實務,我們建議設定以下替代方式來存取您的叢集:

  • 使用 kubectl CLI 存取您的叢集： 遵循這些步驟在您的工作站上使用 kubectl 存取叢集。在這種情況下,您將透過 Rancher 伺服器的身分驗證代理進行驗證,然後 Rancher 會將您連線到下游叢集。這種方法讓您可以在不使用 Rancher UI 的情況下管理叢集。
  • 使用 kubectl CLI 並透過授權叢集端點存取您的叢集： 遵循這些步驟使用 kubectl 直接存取您的叢集,而無需透過 Rancher 進行身分驗證。我們建議設定這種替代方法來存取您的叢集,以便在無法連線到 Rancher 的情況下,您仍然可以存取叢集。