添加外部已有节点

更新时间：2025-08-21

如需将购买的实例添加到 CCE 集群中作为Worker节点，或将移除的 Worker 节点重新加入节点组，您可以在容器引擎 CCE 控制台手动添加节点。添加后，在节点组维度进行统一管理节点。添加前，请仔细阅读使用限制、注意事项等。

前提条件

已成功创建 CCE 集群。
已成功创建节点组。

使用限制

仅支持添加同一账号下的服务器 BCC、BBC、EBC 实例，且添加的 BCC、BBC、EBC 实例必须与集群在同一地域、同一 VPC 下。
不支持添加已属于其他 CCE 集群和节点组的服务器实例。
仅支持与当前节点组实例规格（CPU、内存、GPU卡数）相同的服务器，且付费方式需要与当前节点组一致。
仅支持添加与当前节点组同类型的服务器。
仅支持未开启自动伸缩的节点组添加已有节点，若节点组已开启自动伸缩需要先关闭才能添加已有节点，详情参见节点组管理-配置自动伸缩。
需确保您的集群节点配额充足，关于 CCE 集群的配额限制，请参考 CCE 集群配额限制。

操作步骤

添加集群外已有的服务器实例

登录容器引擎控制台。
在左侧导航栏，选择集群列表。
在“集群列表”页面单击目标集群，进入集群管理页面。
在集群管理页面左侧导航栏中选择节点管理 > 节点组。
在目标节点组操作列选择更多 > 添加已有节点进入扩容节点页面；也可以点击目标节点组，进入节点列表页选择单击添加已有节点进入扩容节点页面。
单击完成按钮，即完成添加已有节点。您可以在“节点组-节点列表”页面中查看添加的节点信息。

配置项	必选/可选	配置说明
节点来源	必选	当前示例选择“集群外”。
节点类型	必选	默认选择节点组配置的服务器类型，不支持修改。
节点选择	必选	选择要加入节点组的服务器实例，支持多选。注意：支持添加的节点数量受集群规模限制。
重装操作系统	必选	重装操作系统，将对所选的实例进行操作系统重装，会清除系统盘内数据且不可恢复（云磁盘数据不受影响）。注意：添加节点不重装操作系统，服务器实例上的旧数据可能会导致节点添加失败或出现其它问题，推荐选择重装操作系统。
已选节点	必选	支持为已选择的节点配置重装操作系统或使用已有配置直接加入集群，当前示例选择“重装操作系统”。重装操作系统，会清除系统盘内数据且不可恢复（云磁盘数据不受影响）。
磁盘挂载	可选	支持选择沿用节点组配置和不沿用节点组配置。默认不沿用节点组配置。不沿用节点组配置：需要选择是否将容器和镜像数据存储在数据盘或本地盘中。勾选：需要填写设备名称、挂载目录。需要注意以下几点：系统将会对所选的全部节点设备格式化为ext4，已经格式化的设备将直接挂目录。被格式化的数据盘内原有数据将会丢失，请提前备份重要数据。您填写的挂载设置会对本批次添加节点全部生效，请确认填写的设备名称符合预期。若输入的设备名称与所选节点的实际名称不匹配，系统会对不匹配的节点报错并终止节点初始化流程。若填写的挂载目录不存在，系统会自动创建对应目录。若所选节点未挂载磁盘，则不会自动挂载新的磁盘。设备名称查询方式请参考查看磁盘信息。不勾选：不设置磁盘挂载选项，可手动或者使用脚本挂载。沿用节点组配置：无需手动填写磁盘挂载配置，系统会自动将节点组的磁盘挂载配置到已选节点。需要注意以下几点：已选节点需要与节点组的实例规格、磁盘数量、磁盘类型、磁盘大小都匹配时，才支持沿用节点组的配置。如果已选节点和节点组不匹配时，已选节点保持原有磁盘配置，不会沿用节点组的配置。当已选节点与节点组机型匹配时，磁盘将被系统格式化为ext4文件系统，已格式化的磁盘将直接进行挂载，系统从最后一块磁盘倒序进行挂载。格式化将会导致原有数据丢失，请注意备份。 BBC类型的已有节点添加至节点组，暂不支持沿用节点组磁盘挂载配置。当已选节点均与节点组不匹配时，则不支持沿用节点组配置。
操作系统配置	必选	当开启重装操作系统时，支持选择沿用节点组配置和不沿用节点组配置，默认不沿用节点组配置。若关闭重装操作系统，则保留已选实例的操作系统配置。沿用节点组配置：无需手动选择操作系统、驱动，系统会自动按照节点组的主机型操作系统、驱动版本重装已选节点。注意: 沿用节点组配置时，系统会清空已选实例自定义驱动（GPU Driver/CUDA/cuDNN等）或“用户数据注入”配置。不沿用节点组配置：需要选择操作系统类型以及镜像版本。注意：如果是GPU节点，按需选择是否安装GPU驱动、CUDA、cuDNN。选择开启自定义安装驱动后，将由系统按照你选择的版本自动为您安装GPU驱动、CUDA、cuDNN。否则，保留实例原有的自定义驱动（GPU Driver/CUDA/cuDNN等）或“用户数据注入”配置。
管理员用户名	必选	登录服务器实例的用户名，Linux 操作系统默认为 root。
登录方式	必选	支持“密钥对”和“自定义密码”。
沿用节点组配置	必选	默认勾选。添加节点的其他配置项，如Worker安全组、节点显存共享、kubelet数据目录、容器数据目录、部署执行脚本、自定义kubelet参数、封锁节点、资源标签、IAM角色是否使用节点组当前的配置信息。若勾选，则添加节点时使用节点组的配置，若不勾选，您也可以自定义相关配置初始化节点。

注意事项：

安全组分为普通安全组和企业安全组，不同类型安全组不能同时绑定，更多信息请见安全组概述。

若安全组类型一样，则会在已有安全组的基础之上加入节点组安全组配置，否则会自动解绑服务器原有安全组，使用节点组的安全组配置。

K8s 标签、污点、Annotation 默认使用节点组当前的配置。

沿用节点组配置时会将云服务器实例绑定IAM角色变更为节点组当前配置，若节点组的IAM角色配置为空，不会对云服务器已绑定的IAM角色进行解绑。

添加集群内游离的节点

登录容器引擎控制台。
在左侧导航栏，选择集群列表。
在“集群列表”页面单击目标集群，进入集群管理页面。
在集群管理页面左侧导航栏中选择节点管理 > 节点组。
在目标节点组操作选择更多 > 添加已有节点进入扩容节点页面；也可以点击目标节点组，进入节点列表页选择单击“添加已有节点”进入扩容节点页面。
单击完成按钮，即完成添加已有节点。您可以在“节点组-节点列表”页面中查看添加的节点信息。

配置项	必选/可选	配置说明
节点来源	必选	当前示例选择“集群内”。
节点类型	必选	默认选择节点组配置的服务器类型，不支持修改。
节点选择	必选	选择要加入节点组的集群中游离的节点（不属于任何节点组），支持多选。注意：支持添加的节点数量受集群规模限制。

说明：

移入节点组后，节点原有的标签（Labels）、污点（Taints）、注解（Annotations）、节点显存共享配置信息、 IAM角色配置会被更新为节点组当前的配置，若节点组的IAM角色配置为空，不会对云服务器已绑定的IAM角色进行解绑。其他配置保持不变。

添加已有实例到节点组中，会保留实例原有的自定义驱动（GPU Driver/CUDA/cuDNN等）或“用户数据注入”配置。

升级节点组

自定义节点组 Kubelet 配置