01

介绍

Go Micro 是一个分布式系统开发框架。Go Micro 提供了分布式系统开发的核心需求,包括 RPC 和事件驱动的通信。Gin 是一个用 Golang 编写的 web 框架。本文首先介绍怎么使用 go-micro 和 go-grpc 构建微服务,然后再介绍怎么集成 gin 和 go-micro。我们使用的 go-micro 版本是 v1.18.0,golang 版本是 v1.13,gin 版本是 v1.7.2。

02

使用 go-micro 和 go-grpc 构建微服务

在我们开始使用 go-micro 之前,我们还需要提前做一些准备工作。安装 protoc、protoc-gen-go 和 protoc-gen-micro,关于如何安装,读者朋友们可以参阅官方文档,我们在之前的文章中也介绍过,限于篇幅,本文不再赘述。

其实,我们可以使用 Go Micro 工具集以命令的方式快速生成模板文件,但是因为本文我们不准备介绍工具集的相关内容,所以我们使用手动创建文件的方式。

下面我们正式开始介绍如何构建服务,包括服务端服务和客户端服务。

服务端

服务端代码目录:

构建服务端服务,分为以下几个步骤:

编写 protobuf 文件

第一步是编写 protobuf 文件,一般会将不同 package 的 protobuf 文件存放在单独的文件目录中。

proto/user/user.proto
user.proto

生成文件

第二步是生成文件,使用命令:

user.pb.gouser.micro.go
user.micro.go

编写 handler

第三步是编写服务端的 handler 代码。

handler/user/user.go

定义服务端服务

main.go
main.go

完成以上 4 个步骤,我们就已经实现了服务端 rpc 服务,接下来,我们开始编写客户端代码。

客户端

客户端代码目录:

构建客户端服务,分为以下几个步骤:

拷贝 proto 文件和生成文件

第一步是拷贝服务端的 proto 文件和生成文件,目的是为了保证服务端和客户端的类型一致性。

定义客户端服务

第二步是定义客户端:

router/v1/user.go

rpc 调用远程服务的方法

第三步是 rpc 调用远程服务的方法:

router/v1/user.go

完成以上 3 步,我们就已经基本编写完客户端的代码。

03

gin 和 go-micro 集成

接下来,我们介绍如何集成 gin 和 go-micro,该部分代码也是在客户端中,共需要两个步骤。

创建路由

router/router.go

启动(监听)服务

main.go

至此,我们已经完成了集成 gin 和 go-micro,启动服务端服务和客户端服务后,我们就可以使用以下命令进行 cURL 测试:

04

总结

本文我们主要介绍怎么使用 go-micro 和 go-grpc 构建微服务,和怎么集成 gin 和 go-micro,并没有介绍 gin 和 go-micro 的使用方法,如果读者朋友们还不了解 gin 和 go-micro,建议先阅读 gin 和 go-micro 官方文档,也可以参考公众号之前推送的关于 gin 的文章。

「阅读完整代码,请点击阅读原文。」

推荐阅读:

参考资料: https://github.com/asim/go-micro https://gin-gonic.com/zh-cn/docs/introduction/