Nacos 迁移方案

最近更新时间:2025-08-15 10:02:32

我的收藏

操作场景

当您在生产环境上已经使用了自建的 Nacos 集群,并希望将其上已运行的服务迁移至腾讯云的 TSE Nacos 时,可以根据您的业务需求,在本指引中选择适合您的迁移方案。
本文主要介绍 TSE Nacos 冷迁移与热迁移的方案和操作步骤,帮助您将自建 Nacos 集群迁移到 TSE Nacos 集群。

迁移原理

Nacos 的核心功能为服务注册发现与配置管理,故一次完整的迁移任务涉及以下两方面:
1. 配置数据迁移:Nacos 的配置数据、用户信息、命名空间数据、访问控制等信息在数据库中持久化存储,如果您的自建集群中已经存在配置数据,需要首先将自建集群中的持久化数据导入至 TSE Nacos。您可以选择以下方式中的一种进行配置数据迁移:
配置数据冷迁移:可以通过 Nacos 的配置数据导入功能,在迁移之初导入自建集群的持久化数据。
配置数据热迁移:可以通过 TSE Nacos 的数据同步功能实现源数据库到 TSE Nacos 数据库的全量迁移与实时增量同步。
2. 服务注册发现迁移:在服务注册发现迁移时,需要切换客户端的注册配置中心地址。您可以选择以下方式进行服务注册发现迁移:
服务冷迁移:如果您的业务可以进行停机迁移,可以直接将服务注册配置中心地址修改为 TSE Nacos。

前提条件

1. 登录 TSE 控制台,新建一个 Nacos 实例,并获取客户端访问地址。详细操作请参见 引擎管理



操作步骤

步骤1:配置数据迁移

方式一:配置数据冷迁移

1. 创建命名空间与权限控制信息:在开始导入配置数据前,前往 TSE Nacos 原生控制台(访问方式请参见 访问控制),并根据您的业务需求,创建与自建集群相应的命名空间与权限控制信息。
2. 导出自建集群配置数据:前往自建 Nacos 集群控制台,在配置列表中依次导出各个命名空间的配置数据。
3. 配置数据导入 TSE Nacos:再次前往 TSE Nacos 原生控制台,在配置管理 - 配置列表中依次导入各个命名空间的配置数据。

方式二:配置数据热迁移

通过 TSE Nacos 的数据同步功能,将源 Nacos 数据库导入与同步至 TSE Nacos 集群。请参见 Nacos 数据同步

步骤2:服务注册发现迁移

1. 将当前注册至自建 Nacos 集群中的服务的注册地址改为 TSE Nacos 的客户端访问地址,并依次重新部署。
说明:
如果您使用了域名访问,则无需重新部署服务,只需要更新域名对应的 Nacos 客户端访问 IP 即可。
2. 部署成功后,在 TSE Nacos 原生控制台的服务管理页面可以看到注册的服务。Nacos 原生控制台的访问方式请参见 访问控制。此时服务仅在 TSE Nacos 集群中进行了注册。
3. 持续观察一段时间,依次验证注册、发现、反注册,如果一切均正常,则可以下线自建的 Nacos 集群。如果您采用了配置数据热迁移,则可以终止数据同步任务。