Go 语言怎么一键生成一个 gRPC 服务?

简介: Go 语言怎么一键生成一个 gRPC 服务?

介绍

Go 开源项目 Micro 为我们提供一套微服务解决方案,它主要包含两个部分,分别是微服务框架 go-micro 和命令行工具 micro

其中, go-micro 是一个易用且强大的框架,很多在生产环境运行的项目中在使用 go-micro v1.x 或 v2.x 版本,因为 v3 版本的变动较大,所以很少项目会选择升级到 v3 版本。

命令行工具 micro 也是基于 go-micro 开发的,它提供了很多便捷功能。

虽然命令行工具不是必须的,我们不使用它,也可以使用 go-micro 创建一个 gRPC 服务。但是,使用命令行工具 micro 可以更加便捷的开发和管理项目。

此外,官方还提供了一些插件 go-pluginsgo-micro 使用插件架构设计,可以非常灵活地组合各种功能,我们也可以自己开发插件,满足我们自己的个性化需求。本文不涉及插件,暂时不做详细介绍。

我们在之前的文章中介绍过不借助命令行工具 micro,直接使用 go-micro 手动编写代码创建一个 gRPC 服务,本文我们介绍怎么使用命令行工具 micro 自动创建一个模板项目。

使用命令行工具 micro 生成 gRPC 服务

安装:

GO111MODULE=on go get github.com/micro/micro/v2@v2.4.0

创建项目:

micro new --namespace=com.foo --gopath=false hello

阅读上面这段命令行代码,我们使用命令行工具 micro 创建一个项目,服务名称是 hello

命令行参数:

  • micro new 使用命令行工具 micro 和其子命令 new 创建一个 gRPC 服务。
  • --namespcae=com.foo 指定服务的命名空间。
  • --gopath=fase 在当前目录生成代码,而不是生成到 GOPATH 目录。
  • hello 指定服务名称。

注意:micro new 的其他参数,感兴趣的读者朋友们请查阅文档。

我们在运行上面这段命令行代码之后,终端会输出以下内容:

Creating service com.foo.service.hello in hello
.
├── main.go
├── generate.go
├── plugin.go
├── handler
│   └── hello.go
├── subscriber
│   └── hello.go
├── proto/hello
│   └── hello.proto
├── Dockerfile
├── Makefile
├── README.md
├── .gitignore
└── go.mod
download protobuf for micro:
brew install protobuf
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
go get -u github.com/micro/protoc-gen-micro/v2
compile the proto file hello.proto:
cd hello
protoc --proto_path=.:$GOPATH/src --go_out=. --micro_out=. proto/hello/hello.proto

阅读上面终端输出的内容,我们可以发现,micro newhello 目录中,为我们自动生成了模板代码。

安装 protobuf 和依赖项:

因为 micro 使用 protobuf 定义服务接口,所以我们需要先安装 protobuf 和依赖项。

brew install protobuf
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
GO111MODULE=on go get -u github.com/micro/protoc-gen-micro/v2

在我们运行 micro new 命令之后,终端中已经为我们输出安装 protobuf 和依赖项的提示,并且提供了安装命令,我们只需运行安装命令即可。

需要注意的是,protoc-gen-micro 是由 micro 官方开发的 protobuf 的扩展,用于生成 micro 的相关代码,我们在安装时,需要显式开启 Go Module

注意:关于 protobuf 的相关内容,我们在之前的文章中介绍过,限于篇幅,本文不再赘述。

构建并运行服务:

虽然 micro new 在生成代码时,为我们生成了一个 Makefile 文件,其中,包含一些常用的任务,我们可以使用 make 命令运行该文件中定义好的任务。

但是我决定在本文中不使用 make 命令,原因是读者朋友们可能有人不熟悉 make,为了避免增加这部分读者的学习成本,我仍然使用 go 命令。

需要注意的是,我们需要先运行 go get 安装指定版本的 go-micro,目的是避免在代码编译期间,自动安装最新版本的 go-micro

cd hello
GO111MODULE=on go get github.com/micro/go-micro/v2@v2.4.0

注意:指定 go-micro 的版本,目的是避免因为版本问题,导致不可预知的陷阱。

在我们使用 go build 构建项目之前,我们先编译 hello.proto 文件。

编译 hello.proto 文件:

cd hello
protoc --proto_path=.:$GOPATH/src --go_out=. --micro_out=. proto/hello/hello.proto

运行编译 hello.proto 文件的命令之后,我们可以发现在 proto/hello 目录中多出两个文件,分别是 hello.pb.gohello.pb.micro.go

构建:

go build -o hello-service *.go

运行构建命令之后,我们可以发现目录中多出一个二进制文件 hello-service

运行服务:

./hello-service
2023-03-04 17:00:54  level=info Starting [service] com.foo.service.hello
2023-03-04 17:00:54  level=info Server [grpc] Listening on [::]:50669
2023-03-04 17:00:54  level=info Broker [eats] Connected to [::]:50671
2023-03-04 17:00:54  level=info Registry [mdns] Registering node: com.foo.service.hello-e0057b02-6432-4d0d-b1e4-2b87ea1034a3
2023-03-04 17:00:54  level=info Subscribing to topic: com.foo.service.hello

到此,我们已经完成使用命令行工具 micro new 创建一个服务名称为 hello 的 gRPC 服务,并且成功构建并运行该服务。

注意:如果遇到一些无法解决的问题,可以尝试删除 GOPATH/pkg/mod 目录下的文件后重试。

03

总结

本文我们介绍怎么使用命令行工具 micro new 创建一个 gRPC 服务,并且怎么构建和运行服务。

需要注意的是,在构建之前,我们先指定 go-micro 版本,避免在代码编译时使用最新版本,掉入不可预知的陷阱。

在安装 micro 官方开发的 protobuf 扩展 protoc-gen-micro 时,我们一定要显式开启 Go Module。

我们安装命令行工具 micro之前,需要先设置代理。因为官方已不维护 go-micro 的 v1 和 v2 版本,所以,我们需要使用代理安装,推荐使用 https://goproxy.cn

推荐阅读:

参考资料:

  1. https://micro.dev/getting-started#creating-a-service
  2. https://github.com/go-micro
目录
打赏
0
0
0
0
8
分享
相关文章
|
3天前
|
公司局域网管理系统里的 Go 语言 Bloom Filter 算法,太值得深挖了
本文探讨了如何利用 Go 语言中的 Bloom Filter 算法提升公司局域网管理系统的性能。Bloom Filter 是一种高效的空间节省型数据结构,适用于快速判断元素是否存在于集合中。文中通过具体代码示例展示了如何在 Go 中实现 Bloom Filter,并应用于局域网的 IP 访问控制,显著提高系统响应速度和安全性。随着网络规模扩大和技术进步,持续优化算法和结合其他安全技术将是企业维持网络竞争力的关键。
17 1
公司局域网管理系统里的 Go 语言 Bloom Filter 算法,太值得深挖了
|
10天前
|
【02】客户端服务端C语言-go语言-web端PHP语言整合内容发布-优雅草网络设备监控系统-2月12日优雅草简化Centos stream8安装zabbix7教程-本搭建教程非docker搭建教程-优雅草solution
【02】客户端服务端C语言-go语言-web端PHP语言整合内容发布-优雅草网络设备监控系统-2月12日优雅草简化Centos stream8安装zabbix7教程-本搭建教程非docker搭建教程-优雅草solution
62 20
探秘员工泄密行为防线:基于Go语言的布隆过滤器算法解析
在信息爆炸时代,员工泄密行为对企业构成重大威胁。本文聚焦布隆过滤器(Bloom Filter)这一高效数据结构,结合Go语言实现算法,帮助企业识别和预防泄密风险。通过构建正常操作“指纹库”,实时监测员工操作,快速筛查可疑行为。示例代码展示了如何利用布隆过滤器检测异常操作,并提出优化建议,如调整参数、结合日志分析系统等,全方位筑牢企业信息安全防线,守护核心竞争力。
|
16天前
|
Go语言入门:分支结构
本文介绍了Go语言中的条件语句,包括`if...else`、`if...else if`和`switch`结构,并通过多个练习详细解释了它们的用法。`if...else`用于简单的条件判断;`if...else if`处理多条件分支;`switch`则适用于基于不同值的选择逻辑。特别地,文章还介绍了`fallthrough`关键字,用于优化重复代码。通过实例如判断年龄、奇偶数、公交乘车及成绩等级等,帮助读者更好地理解和应用这些结构。
35 14
|
30天前
|
内网监控系统之 Go 语言布隆过滤器算法深度剖析
在数字化时代,内网监控系统对企业和组织的信息安全至关重要。布隆过滤器(Bloom Filter)作为一种高效的数据结构,能够快速判断元素是否存在于集合中,适用于内网监控中的恶意IP和违规域名筛选。本文介绍其原理、优势及Go语言实现,提升系统性能与响应速度,保障信息安全。
30 5
Go语言中的map数据结构是如何实现的?
Go 语言中的 `map` 是基于哈希表实现的键值对数据结构,支持快速查找、插入和删除操作。其原理涉及哈希函数、桶(Bucket)、动态扩容和哈希冲突处理等关键机制,平均时间复杂度为 O(1)。为了确保线程安全,Go 提供了 `sync.Map` 类型,通过分段锁实现并发访问的安全性。示例代码展示了如何使用自定义结构体和切片模拟 `map` 功能,以及如何使用 `sync.Map` 进行线程安全的操作。
【01】客户端服务端C语言-go语言-web端PHP语言整合内容发布-优雅草网络设备监控系统-硬件设备实时监控系统运营版发布-本产品基于企业级开源项目Zabbix深度二开-分步骤实现预计10篇合集-自营版
【01】客户端服务端C语言-go语言-web端PHP语言整合内容发布-优雅草网络设备监控系统-硬件设备实时监控系统运营版发布-本产品基于企业级开源项目Zabbix深度二开-分步骤实现预计10篇合集-自营版
25 0
纯Go语言开发人脸检测、瞳孔/眼睛定位与面部特征检测插件-助力GoFly快速开发框架
开发纯go插件的原因是因为目前 Go 生态系统中几乎所有现有的人脸检测解决方案都是纯粹绑定到一些 C/C++ 库,如 OpenCV 或 dlib,但通过 cgo 调用 C 程序会引入巨大的延迟,并在性能方面产生显著的权衡。此外,在许多情况下,在各种平台上安装 OpenCV 是很麻烦的。使用纯Go开发的插件不仅在开发时方便,在项目部署和项目维护也能省很多时间精力。
Go语言开发
【10月更文挑战第26天】Go语言开发
57 3
|
3月前
|
Go语言的开发
【10月更文挑战第25天】Go语言的开发
49 3

热门文章

最新文章