接入VNode（VNodectl工具）

前提条件

• 已部署好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常用命令参考