go micro v3 学习：入门

写在前面：

首先区分，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 因为是个云平台，不需要你去考虑注册问题，所以没有

image.png

安装成功检查

检查GOPATH/bin 目录下是否有3个工具

micro protoc-gen-go  protoc-gen-micro

1. 安装依赖

   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

image.png

• 使用go get github.com/asim/go-micro/cmd/protoc-gen-micro/v3

protoc 生成 xx.micro.go

image.png

我们选择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

image.png

6. 测试服务

创建client/main.go

main.go，编写客户端

package mainimport (
 "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)}

运行客户端

image.png

ps：使用不同版本的protocol buffer工具版本生成的可能有差别