注册附着集群（私网接入）-凯发k8国际娱乐官网入口

约束与限制

• 华为云帐号用户需具备ucs fullaccess和vpcendpoint administrator权限，方可进行集群注册。
• 若集群地域位于境外，应确保您的行为符合所适用的法律法规要求。
• 请确保注册的集群为通过cncf一致性认证，且版本在1.19及以上的kubernetes集群。
• 附着集群通过私网接入时，由于网络限制，镜像仓库功能的使用可能受限：

  私网接入的集群无法通过私网下载swr镜像仓库中的镜像，请确保工作负载运行的节点可访问公网。

前提条件

• 已创建一个准备接入ucs的集群，并且集群状态正常。
• 在ucs提供服务的区域中创建一个vpc，具体操作请参见。当前仅支持“华北-北京四”区域。
  

  该vpc子网网段不能与idc或第三方云中已使用的网络网段重叠，否则将无法接入集群。例如，idc中已使用的vpc子网为192.168.1.0/24，那么华为云vpc中不能使用192.168.1.0/24这个子网。

• 已获取待添加集群的kubeconfig文件，具体操作步骤因厂商而异，请参见。关于kubeconfig文件的更多说明请参考。

步骤一：准备网络环境

云下、云上网络打通后，建议从本地数据中心服务器ping目标vpc下的华为云服务器私网ip，以验证网络是否成功连接。

用户用如下两种方案将线下自有idc或第三方云厂商的网络环境与华为云vpc打通。

• 虚拟专用网络（vpn）方案：请参见通过vpn连接云下数据中心与云上vpc。
• 云专线（dc）方案：请参见用户通过单专线静态路由访问vpc或用户通过单专线bgp协议访问vpc。

步骤二：注册集群

1. 登录ucs控制台。
2. 在左侧导航栏中选择“容器舰队”，单击附着集群选项卡中的“注册集群”按钮。
3. 参考表1填写待添加集群的基础信息，其中带“*”的参数为必填参数。

   表1 注册集群基础信息配置

   参数	参数说明
   集群名称*	输入集群的自定义名称，需以小写字母开头，由小写字母、数字、中划线（-）组成，且不能以中划线（-）结尾。
   集群服务商*	选择一个集群服务商。
   所属区域*	选择集群所在的区域。
   集群标签	非必填项，以键值对的形式为集群添加标签，可以通过标签实现集群的分类。键值对可自定义，以字母或者数字开头和结尾，由字母、数字、连接符（-）、下划线（_）、点号（.）组成，且63个字符之内。
   上传kubeconfig*	上传kubectl的配置文件来完成集群认证，支持json或yaml格式。获取kubeconfig文件的操作步骤因厂商而异，请参见。
   选择context*	选择对应的context。在完成kubeconfig文件上传后，选项列表将自动获取文件中的“contexts”字段。 默认值为kubeconfig文件中“current-context”字段指定的context，若文件中无此字段则需要从列表中手动选择。
   容器舰队	选择集群所属的舰队。 舰队用于权限精细化管理，一个集群只能加入一个舰队。若不选择舰队，集群注册成功后将显示在“未加入舰队的集群”页签下，后续还可以再添加至舰队中。 不支持在注册集群阶段选择已开通集群联邦能力的舰队，如果一定要加入这个舰队，请在集群注册成功后，再添加到该舰队中。关于集群联邦的介绍，请参见开通集群联邦章节。 如需新建舰队，请参见。

4. 单击“确定”，集群注册成功后如图2所示，请在30分钟内接入网络。您可选择集群的接入方式或单击右上角按钮查看详细的网络接入流程。
   如您未在30分钟内接入网络，将会导致集群注册失败，可单击右上角按钮重新注册集群。如果已经接入但数据未采集上来，请等待2分钟后刷新集群。

   图2 集群等待接入状态
   

步骤三：购买终端节点

1. 登录，单击“购买终端节点”。
2. 选择终端节点的区域。
3. 选择“按名称查找服务”，输入服务名称“cn-north-4.open-vpcep-svc.29696ab0-1486-4f70-ab35-a3f6b1b37c02”，并单击“验证”。
   图3 购买终端节点
   
4. 选择步骤一：准备网络环境中与集群网络连通的虚拟私有云以及对应的子网。
5. 根据需求选择终端节点的“节点ip”为“自动分配”或“手动分配”。
6. 配置完其他参数后，单击“立即购买”，并进行规格确认。
   • 规格确认无误，单击“提交”，任务提交成功。
   • 参数信息配置有误，需要修改，单击“上一步”，修改参数，然后单击“提交”。

步骤四：接入集群

1. 登录ucs控制台，在“等待接入”状态下的目标集群栏中单击“私网接入”。
2. 选择项目，选择步骤三：购买终端节点中创建的终端节点。
   图4 选择终端节点
   
3. 将2中的agent配置文件上传至节点。
4. 单击“安装集群代理agent配置”，在待接入集群中执行如下命令，可单击右侧直接复制命令。

   

   

   • 私网接入的集群无法通过私网下载swr镜像仓库中的镜像，请确保工作负载运行的节点可访问公网。
   • 拉取proxy-agent容器镜像要求集群需要具备公网访问能力，或将proxy-agent镜像上传至集群可访问的镜像仓库，否则将导致proxy-agent部署失败。
5. 前往ucs控制台刷新集群状态，集群处于“运行中”。
   图5 集群运行中状态