添加邊緣節點 - Container Service for Kubernetes

ACK Edge叢集的邊緣節點池支援添加多種類型的資源，例如不同地區的ECS節點，IDC節點，其他廠商雲節點，以及分布在工廠、門店、車輛和船舶中的伺服器節點。本文介紹如何在ACK Edge叢集中的邊緣節點池中添加邊緣節點。

前提條件

使用限制

請確保您的叢集配額充足。如需添加更多節點，請到配額平台提交申請擴大配額。關於ACK Edge叢集的配額限制，請參見配額與限制。
添加邊緣節點時會訪問部分網域名稱地址，需要節點側網路安全性群組放開限制允許訪問。具體資訊，請參見邊緣節點訪問網域名稱和IP路由網段配置。

在添加邊緣節點時需要選擇節點作業系統，目前支援接入以下節點作業系統。

系統架構	系統版本	系統核心版本	邊緣Kubernetes叢集版本
AMD64/x86_64	Anolis7.9、Anolis8.6	4.19.X	≥1.16.9-aliyunedge.1
AMD64/x86_64	Alibaba Cloud Linux 2.1903	4.19.X	≥1.20.11-aliyunedge.1
AMD64/x86_64	Alibaba Cloud Linux 3	5.10.X	≥1.20.11-aliyunedge.1
AMD64/x86_64	CentOS 7.4、CentOS 7.5、CentOS 7.6、CentOS 7.7、CentOS 7.8、CentOS 7.9	3.10.X	1.12.6-aliyunedge.1≤叢集版本≤1.30.7-aliyun.1
AMD64/x86_64	CentOS 8.0、CentOS 8.2	4.18.X	1.18.8-aliyunedge.1≤叢集版本≤1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 16.04	4.4.X	1.18.8-aliyunedge.1≤叢集版本≤1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 18.04	4.15.X	1.12.6-aliyunedge.1≤叢集版本≤1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 18.04	5.4.X	≥1.16.9-aliyunedge.1
AMD64/x86_64	Ubuntu 18.04	5.11.X	≥1.18.8-aliyunedge.1
AMD64/x86_64	Ubuntu 20.04	5.4.X	≥1.18.8-aliyunedge.1
AMD64/x86_64	Ubuntu 20.04、Ubuntu 22.04	5.15.X	≥1.26.3-aliyun.1
AMD64/x86_64	Ubuntu 24.04	6.8.X	≥1.30.7-aliyun.1
AMD64/x86_64	Red Hat Enterprise Linux 8.8、Red Hat Enterprise Linux 8.10	4.18.X	1.26.3-aliyun.1≤叢集版本≤1.30.7-aliyun.1
AMD64/x86_64	Kylin V10	4.19.X	≥1.26.3-aliyun.1
AMD64/x86_64	UnionTech OS Server 20	4.19.X	≥1.26.3-aliyun.1
AMD64/x86_64	Red Hat Enterprise Linux 9.3	5.14.X	≥1.30.7-aliyun.1
Arm64	CentOS 8.0	4.19.X	≥1.14.8-aliyunedge.1
Arm64	Ubuntu 18.04	4.9.X	1.14.8-aliyunedge.1≤叢集版本≤1.30.7-aliyun.1
Arm64	Ubuntu 18.04	4.19.X	≥1.14.8-aliyunedge.1
Arm64	Ubuntu 20.04	5.10.X	≥1.22.15-aliyunedge.1

若您想在叢集中添加GPU節點，添加方式請參見添加GPU節點。

添加節點

1.26及以上版本叢集

登入Container Service管理主控台，在左側導覽列選擇叢集列表。
在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇節點管理 > 節點池。
在節點池頁面，選擇目標節點池右側操作列的 > 添加已有節點。

進入添加現有邊緣節點頁面，配置雲邊緣通訊參數和進階選項。

說明

如果以下介面參數無法滿足需求，您可以參考下文參數列表修改產生指令碼中edgeadm的參數完成配置。

分類	配置項	說明
雲邊緣通訊配置	Token 有效時間	表示指令碼的有效時間。預設值為1小時。當此處配置為0小時，表示指令碼永遠生效。如果您需要長時間使用同一個指令碼做大量新增，可以適當增加指令碼的生效時間。
雲邊緣通訊配置	啟用靜默模式	是否啟用靜默模式。在邊緣節點接入執行過程中，某些步驟可能需要您介入做出判斷，例如是否需要將節點上已存在的運行時重新安裝。預設為是，表示所有的問題回答自動回複`yes`，自動推進流程。
進階選項	節點標籤（Labels）	為待接入的節點添加標籤。節點池支援給節點池內所有節點添加標籤的功能。如果該`label`與節點池上的`label key`名稱衝突，節點池上定義的`label`優先順序更高。
	汙點（Taints）	為待接入的節點添加汙點。
	注釋	為待接入的節點添加註解。如果該`annotations`與節點池上的`annotations`名稱衝突，節點池上定義的`annotations`優先順序更高。
	自動完成時間同步	開啟後，表示由edgeadm自動完成時間同步。
	節點網路介面	指定用於擷取節點IP和容器網路通訊使用的主機網卡名稱。如設定為空白，將自動選擇預設路由對應的網卡。
	組件下載自	節點上系統組件鏡像的下載來源。預設為公網。通過私網下載時，節點需已接入專線節點池。
	運行時工作目錄	指定運行時的工作目錄，該配置在`manageRuntime`為`true`時才會生效。 containerd運行時的預設路徑為/var/lib/containerd。

配置完成後單擊確定，進入提交結果頁面，單擊複製，到您的邊緣節點上粘貼並執行該指令碼。
添加邊緣節點成功的結果如下圖所示。

1.26以下版本叢集

登入Container Service管理主控台，在左側導覽列選擇叢集列表。
在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇節點管理 > 節點池。
在節點池頁面，選擇目標節點池右側操作列的 > 添加已有節點。
進入添加節點頁面，預設通過手動添加方式添加現有執行個體。
說明
目前手動添加的方式支援添加雲上ECS節點、雲上ENS節點和非雲節點。
1. 單擊下一步進入執行個體資訊頁面，您可以在此處填寫節點接入配置，具體的配置參數，請參見參數列表。
  說明
  指令碼有效時間的預設值是1小時，如果您需要長時間使用同一個指令碼做大量新增，可以適當增加指令碼的生效時間。當指令碼有效時間配置為0小時，表示指令碼永遠生效。
2. 配置完成後單擊下一步，進入添加完成頁面，單擊複製，到您的邊緣節點上粘貼並執行該指令碼。
添加邊緣節點成功的結果如下圖所示。

參數列表

如果控制台上已有參數無法滿足需求，您可以根據以下參數列表修改產生指令碼中edgeadm的參數完成配置。

參數	與控制台對應的參數	參數說明	描述
`quiet`	啟用靜默模式	是否啟用靜默模式。在節點接入執行過程中，某些步驟可能需要您介入做出判斷，例如是否需要將節點上已存在的運行時重新安裝。	`true`：預設值，假設所有的問題回答自動回複`yes`，自動推進流程。 `false`：節點接入過程中，可能需暫停以擷取您的確認，節點接入過程可能中斷。
`manageRuntime`	無	是否由`edgeadm`檢測並安裝運行時。	`true`：預設值，檢測並安裝運行時。 `false`：不安裝運行時，需要使用者在節點上提前安裝好運行時。
`nodeNameOverride`	無	設定節點名。	`""`：預設值，表示使用主機名稱。 `"XXX"`：表示指定節點名為XXX。 `""`：表示隨機產生6位字串。 `".XXX"`：表示隨機產生6位字串+XXX尾碼。
`allowedClusterAddons`	無	需要安裝的組件列表。普通節點需要配置為["kube-proxy","flannel","coredns"]。	`["kube-proxy","flannel","coredns"]`：預設值。
`gpuVersion`	無	表示要接入的節點是否為GPU節點，預設為空白。當前支援的GPU版本，請參見GPU型號。	`""`：預設值，表示不作為GPU節點接入。 ACK Edge叢集從1.26版本開始，接入Nvidia GPU時，無需配置`gpuVersion`參數直接接入，由接入工具自動檢查GPU型號並安裝相關組件。
`labels`	節點標籤（Labels）	表示接入時節點要加的標籤。節點池支援給節點池內所有節點添加標籤的功能。如果該`label`與節點池上的`label key`名稱衝突，節點池上定義的`label`優先順序更高。	`{}`：表示不添加任何標籤。
`annotations`	注釋	表示接入時給節點加的註解。如果該`annotations`與節點池上的`annotations`名稱衝突，節點池上定義的`annotations`優先順序更高。	`{}`：表示不添加任何註解。
`taints`	汙點（Taints）	表示接入時給節點加上的汙點。	`[]`
`nodeIface`	無	指定主機網卡，該參數有兩個作用： kubelet從指定的網卡擷取節點IP資訊。設定容器網路外掛程式flannel使用的網卡。	`""`：如果設為空白，kubelet將按如下順序擷取節點IP。在/etc/hosts中尋找與主機名稱同名的記錄。預設路由所在的網路介面的IP地址。 flannel將使用節點預設路由所在的網卡。
`runtimeRootDir`	運行時工作目錄	指定運行時的工作目錄，該配置在`manageRuntime`為`true`時才會生效。	`""`：預設值。當運行時為Docker時，預設路徑為/var/lib/docker。當運行時為Containerd時，預設路徑為/var/lib/containerd。
`imageRepoType`	組件下載自	指定節點上系統組件鏡像的下載來源。	`""`：預設值，表示專線節點池的節點從內網下載鏡像，普通節點池的節點從公網下載鏡像。 `public`：表示從公網下載鏡像。 `private`：表示從內網下載鏡像（節點已接入專線節點池）。
`selfHostNtpServer`	自動完成時間同步	是否手動完成時間同步。	`false`：預設值，表示由edgeadm自動完成時間同步。 `true`：表示不需要自動時間同步，已經手動完成時間同步。
`flannelIface`	節點網路介面	flannel使用的網卡名（不推薦使用，可以使用nodeIface參數代替）。	`""`：預設值，flannel使用節點預設路由所使用的網卡。
`enableIptables`	無	edgehub是否開啟iptables最佳化（不推薦使用，1.22後已廢棄）。	`false`：表示不啟用iptables。

Container Service for Kubernetes：添加邊緣節點