Elastic Container Instance：接入VNode（VNodectl工具）

前提條件

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

• 如果您的Kubernetes叢集部署線上下IDC，請確保已通過Express Connect、Smart Access Gateway或者VPN網關打通IDC和雲上網路。相關參考如下：

  • Express Connect

  • Smart Access Gateway

  • 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常用命令參考