# 步骤三：为容器舰队添加集群
您需要注册或纳管集群、为集群接入网络，以便将集群加入容器舰队进行管理。
UCS支持注册华为云集群、本地集群、附着集群、多云集群和伙伴云集群，本小节将以附着集群为例，以公网接入形式指导您快速添加一个Kubernetes集群至容器舰队。
 #### 获取KubeConfig文件
1. 登录待添加集群的Master节点。
2. 获取待添加集群的KubeConfig文件。 
   **cat $HOME/.kube/config**
   ![](https://support.huaweicloud.com/qs-ucs/public_sys-resources/note_3.0-zh-cn.png)
   默认情况下，自建集群的配置文件路径为Master节点的"$HOME/.kube/config"，如您的集群指定了其他KubeConfig配置文件，请自行更换路径。关于KubeConfig文件的详细说明请参见[使用KubeConfig文件组织集群访问](https://kubernetes.io/zh/docs/concepts/configuration/organize-cluster-access-kubeconfig/)。
   
   
3. 复制KubeConfig文件内容。
4. 在本地创建一个YAML文件，将上一步中的复制内容粘贴至该文件并保存。
 
#### 注册集群
1. 登录[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)。
2. 在左侧导航栏选择"容器舰队"，单击附着集群选项卡中的"注册集群"按钮。
3. 配置集群参数。本例中仅填写关键参数，如[表1]所示。
   
    表1添加集群参数配置 
   | 参数             | 是否必需 | 参数说明                                                                                                                             |
   |:---|:---|:---|
   | 集群名称           | 是    | 输入集群的自定义名称。名称需以小写字母开头，由小写字母、数字、中划线（-）组成，且不能以中划线（-）结尾。                                                                            |
   | 集群服务商          | 是    | 选择集群的服务商。                                                                                                                        |
   | 所属区域           | 是    | 选择集群所在区域。                                                                                                                        |
   | 上传KubeConfig文件 | 是    | 上传[获取KubeConfig文件]中保存的KubeConfig文件，以完成集群认证。支持JSON或YAML格式。                                    |
   | 选择Context      | 是    | 选择对应的Context。 Context选项列表会在上传KubeConfig文件后自动获取，默认的选项为KubeConfig文件中"current-context"字段指定的Context。 |
   | 容器舰队           | 否    | 选择[步骤二：创建容器舰队](https://support.huaweicloud.com/qs-ucs/ucs_qs_0008.html)创建的舰队。                                                    |
      
   图1注册集群   
   ![](https://support.huaweicloud.com/qs-ucs/zh-cn_image_0000002057256472.png "点击放大")
   
   
4. 单击"确定"。
 
#### 为集群接入网络
在完成集群注册后，集群需要配置代理来接入网络才能被UCS接管，接入方式包括公网接入与私网接入。
公网接入方式具有操作简单、成本低、弹性灵活的优点，本小节将指导您使用公网接入方式为集群接入网络。如您需要更加高速、低时延、稳定安全的体验，可选择私网接入方式，具体操作请参考[注册附着集群（私网接入）](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0006.html)。
1. 登录[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)。
2. 单击待接入集群栏的"公网接入"，下载集群代理agent的配置文件。
   
   ![](https://support.huaweicloud.com/qs-ucs/public_sys-resources/note_3.0-zh-cn.png)
   集群代理配置存在私有密钥信息，每个集群代理配置仅能下载一次，请您妥善保管。
   
   
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 <Agent Pod Name> | grep "Start serving"
   ```
   如果正常运行，日志预期输出如下：
   ```
   Start serving
   ```
   
   
7. 前往[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)刷新集群状态，集群处于"运行中"。
 
#### 后续步骤
将集群添加至容器舰队后，即可对其进行统一管理。本小节指导您添加了附着集群，您还可以为容器舰队添加其他类型集群，具体操作请参见[UCS集群](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0200.html)。
UCS支持对容器舰队内的多个集群实行统一管理，包括为其开启集群联邦能力以创建和管理多集群工作负载、统一治理多集群流量等能力。
本小节将以四种最常用的UCS功能为例，指导您快速上手UCS的多集群管理能力，请根据业务需求选择您需要参考的入门指导：
- 在多集群上部署并管理工作负载，具体入门操作请参见[创建多集群工作负载](https://support.huaweicloud.com/qs-ucs/ucs_qs_0006.html)。
- 为多集群统一下发实例，具体入门操作请参见[统一下发多集群实例](https://support.huaweicloud.com/qs-ucs/ucs_qs_0007.html)。
- 统一治理多集群流量，具体入门操作请参见[统一治理多集群流量](https://support.huaweicloud.com/qs-ucs/ucs_qs_0005.html)。
- 实现多集群智能、可视化运维，具体入门操作请参见[开启多集群健康监控](https://support.huaweicloud.com/qs-ucs/ucs_qs_0009.html)。