文档中心

容器服务

请输入

创建集群

注册现有集群

VKE 支持通过注册集群方式，将用户本地基础设施或其他云厂商的注册集群注册到容器服务进行统一管理。本文为您详细介绍如何通过代理方式接入集群。

说明

【邀测·申请试用】注册集群目前处于邀测阶段，如需使用，请提交申请。

背景信息

前提条件

使用限制

操作步骤

注册现有集群分两步完成，先配置注册集群并获取代理配置，然后将配置导入源集群，即可完成集群接入。

步骤一：配置注册集群

配置项	说明
名称	自定义注册集群名称，命名规范：长度 2-64 个字符；支持英文字母、汉字、数字和中划线(-）。
连接方式	按实际情况选择导入集群的连接方式，本场景选择代理模式。
云服务商	分布式云原生适配的第三方平台集群，要求选择与待接入集群匹配的云服务商，否则可能导致部分功能不可用。
标签	自定义添加集群标签，用于从不同维度对具有相同特征的集群进行分类、搜索和聚合，能够灵活管理集群。说明单击添加标签即可自定义添加集群标签，单个资源最多可以添加 50 个标签。

配置项	说明
私有网络	待接入注册集群使用的私有网络。
子网	待接入注册集群使用的子网，使用该子网为集群 API Server 创建负载均衡。
API Server 公网访问	默认关闭，若开启此配置，系统将自动创建 EIP（默认配置：BGP、10 Mbps、按量计费，可单击更改 EIP 配置按需更换）并关联注册集群 API Server 负载均衡，即可通过公网连接管理注册集群。注意成功注册集群后，API Server 公网访问策略不支持更新，请根据实际需求提前规划配置。

配置项	说明
集群删除保护	默认开启，用于保护集群，防止误删。开启后不允许通过控制台或调用 API 删除集群。
集群所属项目	项目管理是平台提供的一种资源管理方式，可以对不同业务或项目使用的云资源进行分组管理。基于项目进行 IAM 授权，有利于维护资源独立、数据安全，同时可从项目维度查看资源消费账单，便于计算云资源使用成本。更多详细介绍参见：项目管理。说明默认关联 default 项目，可根据实际需要进行更换。可将单个云账号下的相关云资源归类到项目进行统一管理，但一个资源只能归属于一个项目。
白名单访问控制	默认关闭，用于限制访问注册集群的 IP 地址。若开启并配置白名单 IP CIDR，集群接入时代理 Agent 的接入 IP 和集群接入后允许访问 APIServer 的 IP 将受到限制于配置的白名单范围，否则拒绝访问。白名单配置要求如下：目前支持通过 IP CIDR 方式配置，格式为“x.x.x.0/x”。每行配置一条 IP CIDR，以换行符分隔。不同行的 IP 地址不能重复。

说明

配置确认步骤，将对账户状态、服务授权、产品配额进行前置检查。只有前置检查项全部通过后才能进行注册集群创建操作，若检查失败，需参考详细信息中的报错提示处理问题，然后重新执行注册集群创建操作。

步骤二：导入代理配置

获取注册集群访问凭证后，将代理配置保存在 Yaml 文件中，然后登录源集群运行 Yaml 即可导入代理配置。运行 Yaml 的方法有很多种，以各云服务厂商提供的方式为准。参考步骤如下：

最近更新时间：2026.03.13 10:40:55

这个页面对您有帮助吗？

有用

无用