写在前面:
首先区分,Micro 3.0 和 go micro v3:
- Micro 3.0 是开发go micro 架构的公司的一个云原生开发平台,付费,帮你维护微服务项目,只需要专注业务开发
- go micro 是一个微服务架构
刚接触go micro 3.0 的被搞晕了好久,而且官方文档很乱特此记录一下。
环境搭建
- 安装protobuf
- 安装依赖
- 安装micro工具
1.安装protobuf
1.1 windows环境安装
参考我的另一篇文章:https://www.jianshu.com/p/e3b45139ba48
1.2 linux 环境安装
下载地址 https://github.com/protocolbuffers/protobuf/releases
我下载的是protobuf-all-3.6.1.tar.gz 包
新版本不需要执行autogen.sh脚本,直接./configure就行
tar zvxf protobuf-all-3.6.1.tar.gz
cd protobuf-3.6.1
./configure –prefix=/usr/local/
sudo make #要编译很久一个小时,可以离开吃饭了
sudo make check
sudo make install
安装成功检查:
protoc -h
2. 安装依赖
go get -u github.com/golang/protobuf/proto
go get -u github.com/golang/protobuf/protoc-gen-go
//注意 不要安装下面这个,下面是Micro3.0 云平台的安装工具
//go get github.com/micro/micro/v3/cmd/protoc-gen-micro
//安装asim/go-micro 这个是go micro 3.0 框架
go get github.com/asim/go-micro/cmd/protoc-gen-micro/v3
3. 安装micro v3
//需要用到Micro 3.0 环境的micro 工具,可以快速构建项目,但是不使用这个库,用下面的
go get github.com/micro/micro/v3
// 下载go micro 3.0 库,下面库没有上面micro 工具
go get github.com/asim/go-micro/v3
解释:
asim/go-micro 比 micro/micro更加完整,多了很多我们开发所用的插件还有方法
例如 asim/go-micro 支持consul,而micro/micro 因为是个云平台,不需要你去考虑注册问题,所以没有
安装成功检查
检查GOPATH/bin 目录下是否有3个工具
micro protoc-gen-go protoc-gen-micro
-
安装依赖
go get -u github.com/golang/protobuf/proto go get -u github.com/golang/protobuf/protoc-gen-go go get github.com/micro/micro/v3/cmd/protoc-gen-micro //asim/go-micro 版本 go get github.com/asim/go-micro/cmd/protoc-gen-micro/v3
2. 安装micro v3
go get github.com/micro/micro/v3
go get github.com/asim/go-micro/v3
#安装成功检查
##检查GOPATH/bin 目录下是否有3个工具
micro protoc-gen-go protoc-gen-micro
3. 创建服务
// 因为go get github.com/micro/micro/v3,所有可以执行micro命令
micro new helloworld
cd helloworld
make proto
// windows 没有make命令,打开Makefile 找到protoc命令
// protoc --proto_path=. --micro_out=. --go_out=:. proto/helloworld.proto
注意protoc 区别:
- 如果使用 go get github.com/micro/micro/v3/cmd/protoc-gen-micro
protoc 生成的 proto目录下, xx.pb.micro.go
- 使用go get github.com/asim/go-micro/cmd/protoc-gen-micro/v3
protoc 生成 xx.micro.go
我们选择asim包
4. 修改main.go
import (
"helloworld/handler"
pb "helloworld/proto"
//"github.com/micro/micro/v3/service"
//"github.com/micro/micro/v3/service/logger"
service "github.com/asim/go-micro/v3"
"github.com/asim/go-micro/v3/logger"
)
func main() {
// Create service
// micro/micro 创建服务
//srv := service.New(
// service.Name("helloworld"),
// service.Version("latest"),
//)
// asim/go-micro 创建服务
srv := service.NewService(
service.Name("helloworld"),
service.Version("latest"),
)
// Register handler
pb.RegisterHelloworldHandler(srv.Server(), new(handler.Helloworld))
// Run service
if err := srv.Run(); err != nil {
logger.Fatal(err)
}
}
5. 运行服务端
go run main.go
6. 测试服务
创建client/main.go
main.go,编写客户端
package main
import (
"context"
"fmt"
"github.com/asim/go-micro/v3"
helloworld "helloworld/proto"
)
func main() {
// create a new service
service := micro.NewService()
// parse command line flags
service.Init()
// Use the generated client stub
cl := helloworld.NewHelloworldService("helloworld", service.Client())
// Make request
rsp, err := cl.Call(context.Background(), &helloworld.Request{
Name: "world",
})
if err != nil {
fmt.Println(err)
return
}
fmt.Println(rsp.Msg)
}
运行客户端