您当前的位置:首页 > 电脑百科 > 程序开发 > 语言 > Go语言

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

时间:2023-03-06 13:25:51  来源:微信公众号  作者:Golang语言开发栈


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

​01 介绍

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

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

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

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

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

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

02 使用命令行工具 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 new​ 在 hello 目录中,为我们自动生成了模板代码。

安装 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.go​ 和 hello.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


Tags:Go 语言   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,不构成投资建议。投资者据此操作,风险自担。如有任何标注错误或版权侵犯请与我们联系,我们将及时更正、删除。
▌相关推荐
Go 语言不支持并发读写 Map,为什么?
Go语言的map类型不支持并发读写的主要原因是并发读写会导致数据竞态(data race),这意味着多个 goroutine 可能同时访问并修改同一个 map,从而引发不确定的结果。在Go语言的设计...【详细内容】
2024-01-05  Search: Go 语言  点击:(81)  评论:(0)  加入收藏
Go 语言为什么建议多使用切片,少使用数组?
01 、介绍在 Go 语言中,数组固定长度,切片可变长度;数组和切片都是值传递,因为切片传递的是指针,所以切片也被称为“引用传递”。读者朋友们在使用 Go 语言开发项目时,或者在阅读...【详细内容】
2023-12-27  Search: Go 语言  点击:(134)  评论:(0)  加入收藏
Go 语言使用 Echo 构建高性能 Web 应用
Echo提供了一个高性能且易用的框架,用于构建Go语言编写的Web应用。它具备灵活的路由功能、方便的请求处理、强大的中间件支持和简单的JSON操作,非常适合快速开发API服务和Web...【详细内容】
2023-12-26  Search: Go 语言  点击:(134)  评论:(0)  加入收藏
Go 语言中并发的威力
发挥效率和响应能力并发是现代软件开发中的一个基本概念,它使程序能够同时执行多个任务,提高效率和响应能力。在本文中,我们将探讨并发在现代软件开发中的重要性,并深入了解 Go...【详细内容】
2023-12-21  Search: Go 语言  点击:(115)  评论:(0)  加入收藏
Go 语言字符串使用方式与技巧
01 介绍关于 Go 语言字符串的使用,我们需要了解标准库 strconv 和标准库 strings 的使用方式,它们分别用于字符串类型转换和字符串操作。本文我们重点介绍 Go 语言字符串使用...【详细内容】
2023-12-10  Search: Go 语言  点击:(159)  评论:(0)  加入收藏
Go 语言中的map和内存泄漏
Map在内存中总是会增长;它不会收缩。因此,如果map导致了一些内存问题,你可以尝试不同的选项,比如强制 Go 重新创建map或使用指针。在 Go 中使用map时,我们需要了解map增长和收缩...【详细内容】
2023-11-23  Search: Go 语言  点击:(248)  评论:(0)  加入收藏
Go 语言切片扩容规则是扩容2倍?1.25倍?到底几倍
切片,相信大家用了 Go 语言那么久这这种数据类型并不陌生,但是平日里聊到关于切片是如何扩容的,很多人可能会张口就来,切片扩容的时候,如果老切片的容量小于 1024 那么就再扩容 1...【详细内容】
2023-10-11  Search: Go 语言  点击:(219)  评论:(0)  加入收藏
Go 语言流行 ORM 框架
ORM,全称 Object-Relational Mapping,即对象-关系映射,是一种程序设计技术,用于实现面向对象编程语言里对象的表现形式与关系数据库中数据的存储之间的转换。在实际工作中,我们...【详细内容】
2023-10-05  Search: Go 语言  点击:(232)  评论:(0)  加入收藏
盘点 Go 语言的那些日志库:你用了哪个?
Go语言是一种高性能、简洁、并发友好的编程语言,广泛用于开发各种应用程序,如网络服务、微服务、云计算、区块链等。Go语言的标准库提供了一个基本的日志包(log),可以用于记录简...【详细内容】
2023-09-10  Search: Go 语言  点击:(224)  评论:(0)  加入收藏
为什么说 Go 语言字符串是不可变的?
最近有读者留言说,平时在写代码的过程中,是会对字符串进行修改的,但网上都说 Go 语言字符串是不可变的,这是为什么呢?这个问题本身并不困难,但对于新手来说确实容易产生困惑,今天就...【详细内容】
2023-05-29  Search: Go 语言  点击:(247)  评论:(0)  加入收藏
▌简易百科推荐
宝藏级Go语言开源项目——教你自己动手开发互联网搜索引擎
DIYSearchEngine 是一个能够高速采集海量互联网数据的开源搜索引擎,采用 Go 语言开发。Github 地址:https://github.com/johnlui/DIYSearchEngine运行方法首先,给自己准备一杯...【详细内容】
2024-03-12  OSC开源社区    Tags:Go语言   点击:(19)  评论:(0)  加入收藏
Go Gin框架实现优雅地重启和停止
在Web应用程序中,有时候我们需要重启或停止服务器,无论是因为更新代码还是进行例行维护。在这种情景下,我们需要保证应用程序的可用性和数据的一致性。这就需要优雅地关闭和重...【详细内容】
2024-01-30  源自开发者  微信公众号  Tags:Go   点击:(67)  评论:(0)  加入收藏
如何让Go程序以后台进程或daemon方式运行
本文探讨了如何通过Go代码实现在后台运行的程序。最近我用Go语言开发了一个WebSocket服务,我希望它能在后台运行,并在异常退出时自动重新启动。我的整体思路是将程序转为后台...【详细内容】
2024-01-26  Go语言圈  微信公众号  Tags:Go程序   点击:(60)  评论:(0)  加入收藏
深入Go底层原理,重写Redis中间件实战
Go语言以其简洁、高效和并发性能而闻名,深入了解其底层原理可以帮助我们更好地利用其优势。在本文中,我们将探讨如何深入Go底层原理,以及如何利用这些知识重新实现一个简单的Re...【详细内容】
2024-01-25  547蓝色星球    Tags:Go   点击:(68)  评论:(0)  加入收藏
Go 内存优化与垃圾收集
Go提供了自动化的内存管理机制,但在某些情况下需要更精细的微调从而避免发生OOM错误。本文将讨论Go的垃圾收集器、应用程序内存优化以及如何防止OOM(Out-Of-Memory)错误。Go...【详细内容】
2024-01-15  DeepNoMind  微信公众号  Tags:Go   点击:(63)  评论:(0)  加入收藏
Go函数指针是如何让你的程序变慢的?
导读Go 语言的常规优化手段无需赘述,相信大家也能找到大量的经典教程。但基于 Go 的函数值问题,业界还没有太多深度讨论的内容分享。本文作者根据自己对 Go 代码的使用与调优...【详细内容】
2024-01-15  腾讯云开发者  微信公众号  Tags:Go函数   点击:(88)  评论:(0)  加入收藏
Go编程中调用外部命令的几种场景
在很多场合, 使用Go语言需要调用外部命令来完成一些特定的任务, 例如: 使用Go语言调用Linux命令来获取执行的结果,又或者调用第三方程序执行来完成额外的任务。在go的标准库...【详细内容】
2024-01-09  suntiger    Tags:Go编程   点击:(107)  评论:(0)  加入收藏
Go 语言不支持并发读写 Map,为什么?
Go语言的map类型不支持并发读写的主要原因是并发读写会导致数据竞态(data race),这意味着多个 goroutine 可能同时访问并修改同一个 map,从而引发不确定的结果。在Go语言的设计...【详细内容】
2024-01-05  Go语言圈  微信公众号  Tags:Go 语言   点击:(81)  评论:(0)  加入收藏
Go微服务入门到容器化实践
Go微服务入门到容器化实践Go 是一门高效、现代化、快速增长的编程语言,非常适合构建 Web 应用程序。而 Docker 是一种轻量级的容器化技术,能够使得您的应用程序在任何地方运行...【详细内容】
2024-01-01  大雷家吃饭    Tags:Go微服务   点击:(63)  评论:(0)  加入收藏
你是否想知道如何应对高并发?Go语言为你提供了答案!
并发编程是当前软件领域中不可忽视的一个关键概念。随着CPU等硬件的不断发展,我们都渴望让我们的程序运行速度更快、更快。而Go语言在语言层面天生支持并发,充分利用现代CPU的...【详细内容】
2023-12-29  灵墨AI探索室  微信公众号  Tags:Go语言   点击:(110)  评论:(0)  加入收藏
站内最新
站内热门
站内头条