# 注册附着集群（公网接入）
本章节讲述附着集群的注册及公网接入流程。
#### 约束与限制
- **华为云** **账号**用户需具备UCS FullAccess和VPCEndpoint Administrator权限。

- 若集群地域位于境外，应确保您的行为符合所适用的法律法规要求。
- 请确保注册的集群为通过CNCF一致性认证，且版本为1.19及以上的Kubernetes集群。
 
#### 前提条件
- 已创建一个准备接入UCS的集群，并且集群状态正常。
- 集群中部署proxy-agent组件的节点必须可以进行公网访问，可选择挂载EIP或使用NAT网关的方式。
- 已获取待添加集群的KubeConfig文件，具体操作步骤因厂商而异，请参见[KubeConfig](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0138.html)。关于KubeConfig文件的更多说明请参考[使用kubeconfig文件组织集群访问](https://kubernetes.io/zh/docs/concepts/configuration/organize-cluster-access-kubeconfig/)。
 
#### 步骤一：注册集群
1. 登录[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)。
2. 在左侧导航栏中选择"容器舰队"，单击附着集群选项卡中的"注册集群"按钮。
3. 参考[表1]填写待添加集群的基础信息，其中带"\*"的参数为必填参数。
   
    表1注册集群基础信息配置 
   | 参数             | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                 |
   |:---|:---|
   | 集群名称\*         | 输入集群的自定义名称，需以小写字母开头，由小写字母、数字、中划线（-）组成，且不能以中划线（-）结尾。                                                                                                                                                                                                                                                                                                                                                                  |
   | 集群服务商\*        | 选择一个集群服务商。                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 所属区域\*         | 选择集群所在的区域。                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 集群标签           | 非必填项，以键值对的形式为集群添加标签，可以通过标签实现集群的分类。键值对可自定义，以字母或者数字开头和结尾，由字母、数字、连接符（-）、下划线（_）、点号（.）组成，且63个字符之内。                                                                                                                                                                                                                                                                                                                        |
   | 上传KubeConfig\* | 上传kubectl的配置文件来完成集群认证，支持JSON或YAML格式。获取KubeConfig文件的操作步骤因厂商而异，请参见[KubeConfig](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0138.html)。                                                                                                                                                                                                                                                                       |
   | 选择Context\*    | 选择对应的Context。在完成KubeConfig文件上传后，选项列表将自动获取文件中的"contexts"字段。 默认值为KubeConfig文件中"current-context"字段指定的Context，若文件中无此字段则需要从列表中手动选择。                                                                                                                                                                                                                                                          |
   | 容器舰队           | 选择集群所属的舰队。 舰队用于权限精细化管理，一个集群只能加入一个舰队。若不选择舰队，集群注册成功后将显示在"未加入舰队的集群"页签下，后续还可以再添加至舰队中。 不支持在注册集群阶段选择已开通集群联邦能力的舰队，如果一定要加入这个舰队，请在集群注册成功后，再添加到该舰队中。关于集群联邦的介绍，请参见[开通集群联邦](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0018.html)章节。 如需新建舰队，请参见[管理容器舰队](https://support.huaweicloud.com/usermanual-ucs/ucs_01_0004.html)。 |
      
   
   
4. 单击"确定"，集群注册成功后如[图1]所示，请在30分钟内接入网络。您可选择集群的接入方式或单击右上角![](https://support.huaweicloud.com/usermanual-ucs/zh-cn_image_0000001293009114.png "点击放大")按钮查看详细的网络接入流程。
   
   如您未在30分钟内接入网络，将会导致集群注册失败，可单击右上角![](https://support.huaweicloud.com/usermanual-ucs/zh-cn_image_0000001345751013.png "点击放大")按钮重新注册集群。如果已经接入但数据未采集上来，请等待2分钟后刷新集群。
   图1集群等待接入状态   
   ![](https://support.huaweicloud.com/usermanual-ucs/zh-cn_image_0000001921806549.png "点击放大")
   
   
 
#### 步骤二：接入网络
在UCS控制台成功添加集群后，集群状态将会显示为"等待接入"，此时UCS并未打通与集群的网络连接，因此需要在集群中配置网络代理来接入网络。
1. 登录[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)。
2. 单击待接入集群栏的"公网接入"，下载集群代理agent的配置文件。
   
   ![](https://support.huaweicloud.com/usermanual-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)刷新集群状态，集群处于"运行中"。