步骤三：为容器舰队添加集群-凯发k8国际娱乐官网入口

获取kubeconfig文件

1. 登录待添加集群的master节点。
2. 获取待添加集群的kubeconfig文件。

   cat $home/.kube/config

   

   默认情况下，自建集群的配置文件路径为master节点的“$home/.kube/config”，如您的集群指定了其他kubeconfig配置文件，请自行更换路径。关于kubeconfig文件的详细说明请参见。

3. 复制kubeconfig文件内容。
4. 在本地创建一个yaml文件，将上一步中的复制内容粘贴至该文件并保存。

注册集群

1. 登录ucs控制台。
2. 在左侧导航栏选择“容器舰队”，单击附着集群选项卡中的“注册集群”按钮。
3. 配置集群参数。本例中仅填写关键参数，如表1所示。

   表1 添加集群参数配置

   参数	是否必需	参数说明
   集群名称	是	输入集群的自定义名称。名称需以小写字母开头，由小写字母、数字、中划线（-）组成，且不能以中划线（-）结尾。
   集群服务商	是	选择集群的服务商。
   所属区域	是	选择集群所在区域。
   上传kubeconfig文件	是	上传获取kubeconfig文件中保存的kubeconfig文件，以完成集群认证。支持json或yaml格式。
   选择context	是	选择对应的context。 context选项列表会在上传kubeconfig文件后自动获取，默认的选项为kubeconfig文件中“current-context”字段指定的context。
   容器舰队	否	选择创建的舰队。

   图1 注册集群
   
4. 单击“确定”。

为集群接入网络

在完成集群后，集群需要配置代理来接入网络才能被ucs接管，接入方式包括公网接入与私网接入。

公网接入方式具有操作简单、成本低、弹性灵活的优点，本小节将指导您使用公网接入方式为集群接入网络。如您需要更加高速、低时延、稳定安全的体验，可选择私网接入方式，具体操作请参考。

1. 登录ucs控制台。
2. 单击待接入集群栏的“公网接入”，下载集群代理agent的配置文件。
   

   集群代理配置存在私有秘钥信息，每个集群代理配置仅能下载一次，请您妥善保管。

3. 使用kubectl连接集群，使用如下命令在集群中创建一个名为“agent.yaml”的yaml文件（该文件名称可自定义），并将2中的agent配置内容粘贴到yaml文件中。

   vim agent.yaml

4. 在待接入集群中执行以下命令部署代理。

   kubectl apply -f agent.yaml

5. 查看集群代理部署状态。

   kubectl -n kube-system get pod | grep proxy-agent

   如果部署成功，预期输出如下：

   proxy-agent-5f7d568f6-6fc4k 1/1 running 0 9s

6. 查看集群代理运行状态。

   kubectl -n kube-system logs  | grep "start serving"

   如果正常运行，日志预期输出如下：

   start serving

7. 前往ucs控制台刷新集群状态，集群处于“运行中”。
   图2 集群运行中状态
   

后续步骤

将集群添加至容器舰队后，即可对其进行统一管理。

ucs支持对容器舰队内的多个集群实行统一管理，包括为其开启集群联邦能力以创建和管理多集群工作负载、统一治理多集群流量、为多集群配置统一合规策略等能力。

本小节将以四种最常用的ucs功能为例，指导您快速上手ucs的多集群管理能力，请根据业务需求选择您需要参考的入门指导：

• 在多集群上部署并管理工作负载，具体入门操作请参见。
• 为多集群统一下发实例，具体入门操作请参见。
• 统一治理多集群流量，具体入门操作请参见。
• 实现多集群智能、可视化运维，具体入门操作请参见。