自定义路由用于打通 TCHouse-D 集群的 BE 端口与私有化域名之间的网络链路。该能力面向私有化部署、跨网段访问(如接入 ENI 弹性网卡 / 专线)等场景,将原本需要人工操作的路由配置产品化,规则固化写入节点系统网络配置,节点重启、热迁移或扩容后自动加载,避免手工配置丢失与非对称路由丢包。
功能概述
TCHouse-D 的自定义路由具备以下能力:
1. 持久化生效:路由配置固化到集群节点,节点重启、热迁移、故障替换后自动加载,无需人工补配。
2. 精准路由:按目标网段将流量精确转发到指定出口,打通数据访问链路,不影响集群原有的管控网络通信。
3. 预检校验:创建时对目标网段进行合法性、冲突、保留网段、配额四项校验,提前拦截非法配置。
4. 生命周期管理:支持路由的创建、编辑、删除,以及生效状态的实时查看。
前置准备
1. 已创建 TCHouse-D 集群,并具备集群的管理操作权限。
2. 已就绪目标访问链路对应的 VPC 子网与子网网关。
3. 目标访问流量的目的网段与集群管控 VPC 网段不重叠。
操作指南
新建自定义路由
1. 登录 腾讯云数据仓库 TCHouse 控制台,在实例列表中选择目标集群,进入集群详情>配置管理>网络配置。
2. 单击新建自定义路由,右侧弹出抽屉。
3. 按下表填写各字段:
字段 | 说明 | 示例 |
名称 | 自定义路由名称,支持小写字母、数字、下划线,长度 1–32 字符 | abc_2an |
目标网段 | 符合 IPv4 规范的目标网段,禁止 0.0.0.0/0 及管控 VPC 网段 | 10.10.0.0/16 |
下一跳 | 目标网段流量的下一跳,即用户 VPC 子网网关;多可用区集群默认选择全部节点 VPC. | 172.16.1.1 |
生效范围 | 全部 BE 节点 | - |
备注 | 可选,支持中文、大小写字母、数字、中划线 -、下划线 _,长度 4–64 字符 | abc_2an 用于配置 OIDC |
4. 单击开始预检,系统对目标网段进行校验。
5. 若为存算分离集群,需选择重启方式,对所选的全部 BE 节点执行重启操作。立即重启将导致其正在执行的读写任务失败;滚动重启可能导致执行中的读写任务失败,建议在业务低峰期操作。
6. 预检通过后,单击确定完成创建。
注意:
目标网段须为规范的 IPv4 CIDR;禁止使用 0.0.0.0/0(默认路由)以及集群管控 VPC 网段。
网络配置页面以列表展示当前集群已创建的自定义路由,支持按名称与目标网段精确搜索,最多展示 30 条。
选择“全部 BE 节点”时,节点重启或扩容后会自动向新增 / 重启节点重新下发路由;选择“特定计算组 / 指定 BE 节点”时,仅向选定对象下发,且新增对象不会自动继承。
重启生效范围:
存算一体集群:配置即时生效,无需重启。
存算分离集群:需对所选 BE 节点执行重启后生效。
查看与管理路由
1. 在 网络配置 页面列表中查看已创建的路由,单击某条路由可查看详情。
2. 单击目标路由的编辑,可修改路由的名称、生效节点范围与备注。
3. 单击目标路由的删除可执行删除操作,删除后该网段流量将回退默认路由,可能导致网络不通,请谨慎操作。
常见问题
Q1:配置后节点重启,路由会丢失吗?
不会。路由规则由管控平台通过 Agent 固化写入节点系统网络配置文件,节点重启、热迁移或故障替换后会自动加载,无需人工补配。
Q2:存算分离集群配置后为什么不立即生效?
存算分离架构下路由规则需在 BE 节点层面重新加载,因此需对所选 BE 节点执行重启后才能生效;存算一体集群可即时生效。