地址发现 on Apache Dubbo

使用 Nacos 作为注册中心

Mon, 01 Jan 0001 00:00:00 +0000

本文演示 dubbo-go 使用 Nacos 作为注册中心的服务发现能力，可在 dubbo-go-samples/registry/nacos 查看完整示例源码。

如何启动

启动 Nacos 服务端

服务端注册配置说明

API 配置方式

ins, _ := dubbo.NewInstance(
		dubbo.WithName("dubbo_registry_nacos_server"),
		dubbo.WithRegistry(
			registry.WithNacos(),
			registry.WithAddress(nacosAddr),
		),
		dubbo.WithProtocol(
			protocol.WithTriple(),
			protocol.WithPort(20000),
		),
	)

各配置项的作用如下：

dubbo.WithName() 设置应用名。 dubbo_registry_nacos_server 服务注册后会在 Nacos 中生成对应的应用节点。（此为示例名称）
dubbo.WithRegistry() 添加注册中心配置。
- registry.WithNacos() 指定注册中心类型为 Nacos 。
- registry.WithAddress() 设置 Nacos 地址。
dubbo.WithProtocol() 添加服务提供者的协议配置。
- protocol.WithTriple() 指定使用 Triple 协议对外提供服务。
- protocol.WithPort() 设置协议监听端口，示例使用 20000。

服务注册成功后，可以在 Nacos 的 /services/dubbo_registry_nacos_server 节点下看到服务地址。

YAML 配置方式

如果使用配置文件方式传入配置，而不是 API 的方式，请参考以下 YAML 配置。

使用 ZooKeeper 作为注册中心

Mon, 01 Jan 0001 00:00:00 +0000

本文介绍如何在 Dubbo-Go 中使用 ZooKeeper 作为注册中心。完整示例位于 dubbo-go-samples/registry/zookeeper 目录。

启动 ZooKeeper

使用 Docker 启动

使用 Docker 启动一个本地 ZooKeeper 实例：

docker run --name dubbo-go-zookeeper --rm -d -p 2181:2181 zookeeper:3.9.5

确认容器已经启动：

docker ps --filter name=dubbo-go-zookeeper

使用发行包启动

从 ZooKeeper 下载页面下载二进制发行包。解压后，复制示例配置并启动服务：

tar -xzf apache-zookeeper-3.9.5-bin.tar.gz
cd apache-zookeeper-3.9.5-bin
cp conf/zoo_sample.cfg conf/zoo.cfg
bin/zkServer.sh start

通过以下命令检查运行状态：

bin/zkServer.sh status

看到 Mode: standalone 表示单机 ZooKeeper 已经启动。以上两种方式使用的注册中心地址均为 127.0.0.1:2181。

ZooKeeper 默认还会使用 8080 端口启动管理服务。如果该端口已被占用，可在 conf/zoo.cfg 中设置其他端口后重新启动：

admin.serverPort=18080

配置服务提供者

服务提供者通过 registry.WithZookeeper() 选择 ZooKeeper，并通过 registry.WithAddress() 指定地址：

ins, _ := dubbo.NewInstance(
	dubbo.WithName("dubbo_registry_zookeeper_server"),
	dubbo.WithRegistry(
		registry.WithZookeeper(),
		registry.WithAddress("127.0.0.1:2181"),
	),
	dubbo.WithProtocol(
		protocol.WithTriple(),
		protocol.WithPort(20000),
	),
)

各配置项的作用如下：

应用级服务发现

Mon, 01 Jan 0001 00:00:00 +0000

dubbo-go 支持接口级注册和应用级服务发现。接口级注册会把可调用的 provider URL 直接写入注册中心；应用级服务发现会把应用实例写入注册中心，再通过服务映射和 metadata 还原 consumer 调用所需的 provider URL。

应用级服务发现是当前默认模型。接口级注册和应用级服务发现使用不同的注册与订阅路径，二者不会自动互通。使用接口级发现的 consumer 无法发现只注册应用级实例的 provider；使用应用级服务发现的 consumer 也无法发现只注册接口级 URL 的 provider。如果迁移阶段需要同时支持两类 consumer，可以使用 all。

注册模式

可以通过 registry type 选择 provider 的注册方式：

Registry type	API 配置	注册内容
`interface`	`registry.WithRegisterInterface()`	provider URL，例如 `tri://host:port/interface` 或 `rest://host:port/interface`。
`service`	`registry.WithRegisterService()`	应用实例和实例 metadata。consumer 先发现实例，再通过 metadata 解析 provider URL。
`all`	`registry.WithRegisterServiceAndInterface()`	同时注册应用级实例和接口级 provider URL，适合迁移阶段使用。

示例：

ins, _ := dubbo.NewInstance(
	dubbo.WithName("demo-provider"),
	dubbo.WithRegistry(
		registry.WithNacos(),
		registry.WithAddress("127.0.0.1:8848"),
		registry.WithRegisterService(),
	),
)

如果使用配置文件，可以将 registry-type 设置为 service、interface 或 all。如果对注册方式有明确要求，建议显式配置。

多注册中心

Mon, 01 Jan 0001 00:00:00 +0000

一个 Dubbo 应用可以配置的多个接口维度的注册中心，多注册中心可用于集群隔离、迁移等多种场景，关于这部分更详细的说明可参考 Dubbo Java 多注册中心说明。

应用场景

迁移场景

在不同注册中心之间实现平滑迁移，不进行服务的中断。例如从 ZooKeeper 迁移到 Nacos，双注册保证过渡期间业务连续。

灰度发布场景

部署独立的灰度注册中心，仅特定流量可访问测试。新版本先注册到灰度中心，验证通过后再全量发布，降低上线风险。

集群/环境隔离场景

将不同的服务环境使用完全独立的注册中心隔离，互不干扰。开发、测试、生产各自独立，避免调试服务影响线上业务。

API配置方式

服务端

ins, _ := dubbo.NewInstance(
	dubbo.WithName("dubbo_multi_registry_server"),
	dubbo.WithRegistry(
		registry.WithID("nacos"),
		registry.WithNacos(),
		registry.WithAddress("127.0.0.1:8848"),
	),
	dubbo.WithRegistry(
		registry.WithID("zookeeper"),
		registry.WithZookeeper(),
		registry.WithAddress("127.0.0.1:2181"),
	),
)

指定某个 server 下的服务注册到哪个注册中心：

// 指定 server 下的服务注册到 zookeeper 注册中心
srv, _ := ins.NewServer(server.WithServerRegistryIDs([]string{"zookeeper"}))

// 指定 server 下的服务注册到 nacos 注册中心
srv2, _ := ins.NewServer(server.WithServerRegistryIDs([]string{"nacos"}))

指定某个特定服务注册到哪个注册中心：

srv, _ := ins.NewServer()

greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{}, server.WithRegistryIDs([]string{"zookeeper"}))

客户端

ins, _ := dubbo.NewInstance(
	dubbo.WithName("dubbo_multi_registry_client"),
	dubbo.WithRegistry(
		registry.WithID("nacos"),
		registry.WithNacos(),
		registry.WithAddress("127.0.0.1:8848"),
	),
	dubbo.WithRegistry(
		registry.WithID("zookeeper"),
		registry.WithZookeeper(),
		registry.WithAddress("127.0.0.1:2181"),
	),
)

指定从哪个注册中心订阅服务：