前提條件

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

• 如果您的Kubernetes集群部署在線下IDC，請(qǐng)確保已通過高速通道、智能接入網(wǎng)關(guān)或者VPN網(wǎng)關(guān)打通IDC和云上網(wǎng)絡(luò)。相關(guān)參考如下：

  • 高速通道

  • 智能接入網(wǎng)關(guān)

  • VPN網(wǎng)關(guān)

準(zhǔn)備工作

操作前，請(qǐng)準(zhǔn)備創(chuàng)建VNode所需的參數(shù)信息，并了解VNode所需的權(quán)限信息。需要準(zhǔn)備的參數(shù)如下表所示。

創(chuàng)建VNode時(shí)，需要配置相關(guān)權(quán)限，包括原生K8s節(jié)點(diǎn)使用的標(biāo)準(zhǔn)權(quán)限，以及VNode所需的額外權(quán)限，具體如下表所示。

安裝VNodectl

操作前，您需要安裝VNodectl命令行工具。請(qǐng)根據(jù)自身環(huán)境獲取對(duì)應(yīng)的安裝包并安裝VNodectl。

建議您將VNodectl安裝在Kubernetes集群的master節(jié)點(diǎn)上，操作步驟如下：

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. 復(fù)制vnodectl到指定目錄。

   cp vnodectl /usr/local/bin/vnode

配置集群

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

配置~/.vnode/config文件

~/.vnode/config文件包含了VNode的配置信息，VNodectl運(yùn)行的時(shí)候會(huì)讀取該文件，因此在創(chuàng)建VNode前需要先配置好該文件。

1. 打印VNode運(yùn)行所需的配置信息。

   vnode config default

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

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

   

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

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

   請(qǐng)根據(jù)自身需求修改~/.vnode/config文件內(nèi)容，以下示例僅配置了必填字段。

   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. 查看并確認(rèn)當(dāng)前VNode運(yùn)行讀取的配置信息。

   vnode config

4. 切換context，使VNode運(yùn)行加載context下的配置。

   vnode config set-context <context-name>

創(chuàng)建VNode

1. 創(chuàng)建一個(gè)VNode。

   vnode create

   說明

   創(chuàng)建時(shí)會(huì)采用~/.vnode/config文件中的配置進(jìn)行創(chuàng)建，支持添加參數(shù)來配置customResources、clusterDNS和clusterDomain。更多信息，請(qǐng)參見管理VNode

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

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

2. 查看VNode狀態(tài)。

   vnode list

   返回示例如下，當(dāng)STATUS為Ready時(shí)，表示VNode創(chuàng)建成功。

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

3. 查看節(jié)點(diǎn)信息。

   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調(diào)度到VNode

由于VNode不是真實(shí)節(jié)點(diǎn)，因此無法運(yùn)行DaemonSet。創(chuàng)建VNode后，您需要修改kube-proxy的DaemonSet，配置nodeAffinity來禁止DaemonSet調(diào)度到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

調(diào)度Pod到VNode

創(chuàng)建VNode后，您可以通過以下方式將Pod調(diào)度到VNode上，以使用ECI來運(yùn)行Pod。

• 手動(dòng)調(diào)度

  通過配置nodeSelector和tolerations、指定nodeName的方式，可以手動(dòng)將Pod調(diào)度到VNode。具體操作，請(qǐng)參見將Pod調(diào)度到VNode。

• 自動(dòng)調(diào)度

  部署eci-profile組件后，可以自定義配置Selector，將滿足條件的Pod自動(dòng)調(diào)度到VNode。具體操作，請(qǐng)參見使用eci-profile調(diào)度Pod到VNode。

相關(guān)文檔

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

• VNodectl常用命令參考