服务注册与分布式协调 / 系统课时

用集群名实现同区域优先调用

用集群名实现同区域优先调用

本节用 Nacos 实例的 clusterName 表达部署区域,并通过“先查本地集群、为空再查全部集群”的方式验证同区域优先与跨区域回退。完成后,你会知道集群名能提供什么能力,以及为什么真正的优先调用仍需要消费端选择策略配合。

学习目标

  • 使用 clusterName 把同一服务的实例划分到不同区域集群。
  • 实现并验证本地集群优先、无本地实例时再跨区域回退。
  • 识别“配置了集群名就会自动就近调用”这一常见误区。

集群名如何表达区域

同一服务可以同时存在多个集群,例如 us-west 与 us-east。实例注册时写入 clusterName,消费端查询时用 clusters 参数只取本地集群,就能先得到同区域候选实例。

关键点是:集群名负责分组,不等于所有客户端都会自动执行就近路由。调用方需要显式使用支持集群感知的负载均衡策略,或者像下面示例一样先查询本地集群;本地没有候选实例时,再决定是否允许跨区域回退。

同区域优先与跨区域回退流程

配置并验证同区域优先

下面仍使用默认命名空间和默认分组,假设 Nacos 位于 127.0.0.1:8848,并已安装 curl、jq。脚本先注册西部和东部两个实例,第一次选择应命中 us-west;随后删除本地实例,再次选择就会走跨区域回退。

bash
BASE="http://127.0.0.1:8848"
SERVICE="demo-cluster-service"
LOCAL_CLUSTER="us-west"

# 同一服务注册到两个集群,clusterName 用来表达区域分组。
curl -s -X POST "$BASE/nacos/v1/ns/instance" --data-urlencode "serviceName=$SERVICE" --data-urlencode "ip=127.0.0.1" --data-urlencode "port=18091" --data-urlencode "clusterName=$LOCAL_CLUSTER"; echo
curl -s -X POST "$BASE/nacos/v1/ns/instance" --data-urlencode "serviceName=$SERVICE" --data-urlencode "ip=127.0.0.1" --data-urlencode "port=18092" --data-urlencode "clusterName=us-east"; echo

select_instance() {
  local local_json
  local_json=$(curl -sG "$BASE/nacos/v1/ns/instance/list" --data-urlencode "serviceName=$SERVICE" --data-urlencode "clusters=$LOCAL_CLUSTER")
  # 先只看本地集群;有候选时不跨区域。
  if [ "$(jq '.hosts | length' <<<"$local_json")" -gt 0 ]; then
    jq -r '.hosts[0] | "selected=\(.ip):\(.port) cluster=\(.clusterName) source=local"' <<<"$local_json"
    return
  fi
  # 本地为空时再查询全部集群,显式形成回退。
  curl -sG "$BASE/nacos/v1/ns/instance/list" --data-urlencode "serviceName=$SERVICE" | jq -r '.hosts[0] | "selected=\(.ip):\(.port) cluster=\(.clusterName) source=fallback"'
}

select_instance
curl -s -X DELETE "$BASE/nacos/v1/ns/instance" --data-urlencode "serviceName=$SERVICE" --data-urlencode "ip=127.0.0.1" --data-urlencode "port=18091" --data-urlencode "clusterName=$LOCAL_CLUSTER"; echo
select_instance

预期输出

text
ok
ok
selected=127.0.0.1:18091 cluster=us-west source=local
ok
selected=127.0.0.1:18092 cluster=us-east source=fallback

示例只用“取第一个实例”证明选择范围发生了变化,生产环境应在本地候选集合内继续执行随机、轮询或权重负载均衡,而不是固定使用列表第一项。

回退策略的边界

跨区域回退不是越积极越好。远端实例通常意味着更高网络延迟、跨区流量费用,以及更复杂的故障影响面。对强地域约束服务,可以选择“本地无实例就快速失败”;对可降级服务,则可以允许跨区域回退,并为这类调用单独监控延迟和错误率。

还要避免把 clusterName 与自定义 metadata.region 混为一谈。前者是 Nacos 实例内建的集群维度,可以直接用于集群过滤;后者是普通业务标签,更适合版本、发布批次等自定义治理条件。两者可以同时存在,但应各司其职。

如果使用 Spring Cloud Alibaba 或自研 SDK 封装,最终都要验证一件事:消费端拿到的候选实例是否先限制在本地集群,并且只有本地集合为空或不可用时才扩大范围。只配置 clusterName 而不检查客户端选择策略,无法证明已经实现同区域优先调用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用集群名实现同区域优先调用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通