开发微服务

Dubbo-go 快速开始

本示例演示了使用 dubbo-go 开发微服务应用，为应用增加包括服务发现、负载均衡、流量管控等微服务核心能力。

前置条件

本示例我们继续使用 Protobuf 开发微服务应用，请参考开发 rpc server 和 rpc client 了解如何安装 protoc、protoc-gen-go-triple 等必须插件。

快速运行示例

下载示例源码

我们在 apache/dubbo-go-samples 仓库维护了一系列 dubbo-go 使用示例，用来帮助用户快速学习 dubbo-go 使用方式。

$ git clone --depth 1 https://github.com/apache/dubbo-go-samples

切换到快速开始示例目录：

$ cd dubbo-go-samples/registry/nacos

启动 Nacos

由于示例应用中启用了服务发现能力且使用 Nacos 作为注册中心，在运行示例之前需要先启动注册中心。请参考 Nacos 本地安装了解如何快速安装和启动 Nacos。

运行 server

在 go-server/cmd 示例目录：

运行以下命令，启动 server：

$ go run server.go

使用 cURL 验证 server 正常启动：

$ curl \
    --header "Content-Type: application/json" \
    --data '{"name": "Dubbo"}' \
    http://localhost:50051/greet.v1.GreetService/Greet
Greeting: Hello world

运行 client

打开一个新的 terminal，运行以下命令，启动 client

$ go run client.go
Greeting: Hello world

以上就是一个完整的 dubbo-go 微服务应用工作流程。

源码讲解

关于 dubbo-go-samples/registry/nacos 示例源码，包括服务定义、代码生成、server/client 启动等均与上一篇 rpc server & rpc client 类似，请点击以上链接查看具体解读。

开发微服务最大的不同点在于：应用中增加了关于注册中心的配置，如下所示（以 server.go 为例）：

func main() {
    ins, err := dubbo.NewInstance(
        dubbo.WithName("dubbo_registry_nacos_server"),
        dubbo.WithRegistry(
            registry.WithNacos(),
            registry.WithAddress("127.0.0.1:8848"),
        ),
        dubbo.WithProtocol(
            protocol.WithTriple(),
            protocol.WithPort(20000),
        ),
    )
    srv, _ := ins.NewServer()
    greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{})
    if err := srv.Serve(); err != nil {
        logger.Error(err)
    }
}

相比于开发 rpc 服务时我们直接声明 server.NewServer(...)，这里我们使用 dubbo.newInstance(...) 初始化了一些全局共享的微服务核心组件，包括应用名、注册中心、协议等：

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

然后，才是创建 ins.NewServer() 并为 server 实例注册服务 greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{})，最后通过 srv.Serve() 启动进程。

关于 dubbo.Insance 说明

在开发 dubbo 微服务应用时，我们推荐使用 dubbo.Instance 来设置一些全局性的服务治理能力，如注册中心、协议、应用名、tracing、配置中心等。
ins.NewServer() 可以创建多个，通常当你需要在多个端口发布多个协议时才需要这么做。

如果你要为应用添加更多服务治理能力，请参考以下内容：

开发微服务应用

开发微服务

前置条件

快速运行示例

下载示例源码

启动 Nacos

运行 server

运行 client

源码讲解

关于 dubbo.Insance 说明

更多内容

服务发现与负载均衡

流量管控

监控服务状态

全链路追踪

网关 HTTP 接入

分布式事务