前提條件

• 已部署好Kubernetes集群，且集群的版本屬于1.13~1.30版本。

• 如果您的Kubernetes集群部署在線下IDC，請確保已通過高速通道、智能接入網關或者VPN網關打通IDC和云上網絡。相關參考如下：

  • 高速通道

  • 智能接入網關

  • VPN網關

準備工作

操作前，請準備創建VNode所需的參數信息，并了解VNode所需的權限信息。需要準備的參數如下表所示。

創建VNode時，需要配置相關權限，包括原生K8s節點使用的標準權限，以及VNode所需的額外權限，具體如下表所示。

安裝VNodectl

操作前，您需要安裝VNodectl命令行工具。請根據自身環境獲取對應的安裝包并安裝VNodectl。

建議您將VNodectl安裝在Kubernetes集群的master節點上，操作步驟如下：

1. 連接集群。

2. 下載安裝包。

   wget https://eci-docs.oss-cn-beijing.aliyuncs.com/vnode/vnodectl_0.0.5-beta_linux_amd64.tar.gz -O vnodectl.tar.gz 

3. 解壓安裝包。

   tar xvf vnodectl.tar.gz 

4. 復制vnodectl到指定目錄。

   cp vnodectl /usr/local/bin/vnode

配置集群

VNode需要使用kubeconfig來接入集群。因此，創建VNode前需要為VNode簽發證書（即kubeconfig）。配置方式分為TLS Bootstrap方式和ServiceAccount方式。

配置~/.vnode/config文件

~/.vnode/config文件包含了VNode的配置信息，VNodectl運行的時候會讀取該文件，因此在創建VNode前需要先配置好該文件。

1. 打印VNode運行所需的配置信息。

   vnode config default

   配置信息中contexts下各字段說明如下：

   字段	是否必填	說明
   name	是	context名稱。
   vnode-name	否	VNode名稱，建議不配置，由系統自動生成可保證唯一性
   region-id	是	VNode所屬地域。請參考準備工作選擇。
   access-key-id	是	調用阿里云API時需要使用AccessKey完成身份驗證。AccessKey包括AccessKey ID和AccessKey Secret，需要一起使用。更多信息，請參見創建AccessKey。
   access-key-secret	是
   vswitch-id	是	VNode所屬交換機，可配置多個。請參考準備工作創建。
   security-group-id	是	VNode所屬安全組。請參考準備工作創建。
   resource-group-id	否	VNode所屬資源組。 資源組是在阿里云賬號下進行資源分組管理的一種機制。每個賬號有一個默認資源組。更多信息，請參見資源管理。 如果沒有指定資源組，則VNode將加入到默認資源組中。
   kubeconfig	是	VNode接入集群時所需的kubeconfig文件路徑。完成配置集群操作后會自動生成，默認路徑為~/.vnode/deploy/kubeconfig。
   taints	否	VNode綁定的污點信息。
   tags	否	VNode綁定的標簽信息。 標簽可用于賬單分賬管理，為VNode綁定自定義標簽后，在查看費用分析時，可以通過該標簽篩選出VNode收取的實例費用。更多信息，請參見基于標簽查詢分賬賬單。

   

2. 將配置信息重定向到指定文件（~/.vnode/config），并配置各字段。

   vnode config default > ~/.vnode/config
   vim ~/.vnode/config

   請根據自身需求修改~/.vnode/config文件內容，以下示例僅配置了必填字段。

   kind: vnode
   contexts:
       - name: default
         region-id: cn-guangzhou
         access-key-id: LTAI5tJbBkHcHBUmuP7C****
         access-key-secret: 5PlpKJT6sgLcD4f9y5pACNDbEg****
         vswitch-id: vsw-7xv2yk45qp5etidgf****
         security-group-id: sg-7xv5tcch4kjdr65t****
         kubeconfig: ~/.vnode/deploy/kubeconfig
   current-context: default

3. 查看并確認當前VNode運行讀取的配置信息。

   vnode config

4. 切換context，使VNode運行加載context下的配置。

   vnode config set-context <context-name>

創建VNode

1. 創建一個VNode。

   vnode create

   說明

   創建時會采用~/.vnode/config文件中的配置進行創建，支持添加參數來配置customResources、clusterDNS和clusterDomain。更多信息，請參見管理VNode

   返回示例如下，其中VirtualNodeId的值即為生成的VNode的ID。

   {"RequestId":"AB772F9D-2FEF-5BFD-AAFB-DA3444851F29","VirtualNodeId":"vnd-7xvetkyase7gb62u****"}

2. 查看VNode狀態。

   vnode list

   返回示例如下，當STATUS為Ready時，表示VNode創建成功。

   VNODE ID                    VNODE NAME                                   CREATED          STATUS    SCHEDULABLE ZONES
   vnd-7xvetkyase7gb62u****    vnode-cn-guangzhou-a-7xvetkyase7gb62u****    2 minutes ago    Ready     cn-guangzhou-a

3. 查看節點信息。

   kubectl get node

   返回示例如下，可以看到集群中已接入VNode。

   NAME                                    STATUS     ROLES                  AGE    VERSION
   cn-guangzhou.vnd-7xvetkyase7gb62u****   Ready      agent                  174m   v1.20.6
   vnode-test001                           Ready      control-plane,master   23h    v1.20.6
   vnode-test002                           Ready      <none>                 22h    v1.20.6

禁止DaemonSet調度到VNode

由于VNode不是真實節點，因此無法運行DaemonSet。創建VNode后，您需要修改kube-proxy的DaemonSet，配置nodeAffinity來禁止DaemonSet調度到VNode。

1. 修改DaemonSet配置。

   kubectl -n kube-system edit ds kube-proxy

2. 配置nodeAffinity。

   在spec>template>spec下添加以下YAML：

   affinity:
     nodeAffinity:
       requiredDuringSchedulingIgnoredDuringExecution:
         nodeSelectorTerms:
         - matchExpressions:
           - key: type
             operator: NotIn
             values:
             - virtual-kubelet

調度Pod到VNode

創建VNode后，您可以通過以下方式將Pod調度到VNode上，以使用ECI來運行Pod。

• 手動調度

  通過配置nodeSelector和tolerations、指定nodeName的方式，可以手動將Pod調度到VNode。具體操作，請參見將Pod調度到VNode。

• 自動調度

  部署eci-profile組件后，可以自定義配置Selector，將滿足條件的Pod自動調度到VNode。具體操作，請參見使用eci-profile調度Pod到VNode。

相關文檔

• ECS上自建Kubernetes集群快速接入VNode

• VNodectl常用命令參考