搭建 go-micro 开发环境

最近因为要用到 go-micro,所以在学习微服务相关的内容,这一篇是记录 micro 的搭建过程。

安装环境

micro 提供了一个 runtime,在使用 go-micro 之前需要先安装它。有以下几种方式安装

源码

go get github.com/micro/micro/v2

这种方式我装不上,不是网络的原因,不知道哪里有冲突。。。

docker

docker pull micro/micro

二进制

# MacOS
curl -fsSL https://raw.githubusercontent.com/micro/micro/master/scripts/install.sh | /bin/bash

# Linux
wget -q  https://raw.githubusercontent.com/micro/micro/master/scripts/install.sh -O - | /bin/bash

# Windows
powershell -Command "iwr -useb https://raw.githubusercontent.com/micro/micro/master/scripts/install.ps1 | iex"

推荐使用这种方式下载安装,把编译好的二进制包添加到环境变量就能直接使用了。不想用脚本安装可以在 github 的 release 页面下载

https://github.com/micro/micro/releases

测试一下

现在已经安装好 micro 了,测试一下。

micro web

输出

$ micro web
2020-07-05 04:24:16  file=http/http.go:90 level=info service=web HTTP API Listening on [::]:8082
2020-07-05 04:24:16  file=v2@v2.9.1/service.go:200 level=info service=web Starting [service] go.micro.web
2020-07-05 04:24:16  file=grpc/grpc.go:864 level=info service=web Server [grpc] Listening on [::]:26449
2020-07-05 04:24:16  file=grpc/grpc.go:697 level=info service=web Registry [mdns] Registering node: go.micro.web-b76a12a1-5226-429f-9633-ce304f179657

现在访问localhost:8082 就可以查看 micro 的 web 页面了。

安装 protoc

protoc 是 protobuf 的编译器,而 protobuf 是一种用来传输数据的格式,类似 json、xml 这些。
protoc 下载地址

https://github.com/protocolbuffers/protobuf/releases

下载好之后,bin 文件夹中有个 protoc 的可执行文件,把这个也添加到环境变量。(可以直接把它放到已经添加了环境变量的文件夹下就可以了,可以避免电脑里写满了各种环境变量,并且常用工具放到一个文件夹也方便管理)

还有个 protoc-gen-go 也需要放进去,可以用下面的方式下载。

go get -u github.com/golang/protobuf/proto
go get -u github.com/golang/protobuf/protoc-gen-go

example

现在让我们写一个 demo 来练习一下。

一共有三个文件,server.goclient.gogreeter.proto

greeter.proto

syntax = "proto3";
package protos;

service Greeter {
    rpc Hello (Request) returns (Response){};
}

message Request {
    string name = 1;
}

message Response {
    string greeting = 2;
}

server.go

package main

import (
    "context"
    "fmt"
    "github.com/micro/go-micro/v2"
)

type Greeter struct {
}

func (g *Greeter) Hello(context context.Context, req *Request, rsp *Response) error {
    rsp.Greeting = "Hello " + req.Name
    return nil
}

func main() {
    service := micro.NewService(
        micro.Name("greeter"),
    )
    service.Init()

    err := RegisterGreeterHandler(service.Server(), new(Greeter))
    if err != nil {
        fmt.Println(err)
    }

    if err := service.Run(); err != nil {
        fmt.Println(err)
    }
}

client.go

package main

import (
    "context"
    "fmt"
    "github.com/micro/go-micro/v2"
)

func main() {
    service := micro.NewService(micro.Name("greeter.client"))
    service.Init()

    greeter := NewGreeterService("greeter", service.Client())
    rsp, err := greeter.Hello(context.TODO(), &Request{Name: "Zaun pianist"})
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(rsp.Greeting)
}

强烈建议使用 go mod 来管理依赖,项目更新速度很快,百度上的很多教程都不行了,安装过程各种错误

这是我的 mod 文件

module hello

go 1.14

require (
    github.com/golang/protobuf v1.4.0
    github.com/micro/go-micro/v2 v2.9.1
    google.golang.org/protobuf v1.22.0
)

注意,我的 greeter.proto 和 server.go、client.go 文件是放在同一个文件夹下面的

编译greeter.proto

protoc --micro_out=. --go_out=. greeter.proto

编译完成之后,会生成两个 go 源代码文件:

  • greeter.pb.go
  • greeter.pb.micro.go

运行

现在可以运行 server 了,这里因为 client 和 server 是放在同一个文件夹,也就是同一个包中,两个都有 main 函数,所以不能用 go run ./,至于为什么要加上另外两个,这个是 go 语言编译器的要求,必须要指明编译所需要用到的文件。

go run server.go greeter.pb.go greeter.pb.micro.go

可以用 micro 来查看当前正在运行的微服务

micro list services

也可以在 web 端查看

micro web

如果没有出错,这个时候是可以看到服务已经注册成功了。

$ micro list services
go.micro.web
greeter

测试

现在可以运行客户端来测试一下了

go run client.go greeter.pb.go greeter.pb.micro.go

我在测试的时候出了问题,服务已经注册好了,但是 client 去调用的时候,缺返回了

{"id":"go.micro.client","code":408,"detail":"context deadline exceeded","status":"Request Timeout"}
panic: runtime error: invalid memory address or nil pointer dereference
[signal 0xc0000005 code=0x0 addr=0x28 pc=0xeef454]

检查一下服务的信息

micro get service greeter
$ micro get service greeter                                                                                    
service  greeter                                                                                               

version latest                                                                                                 

ID      Address Metadata                                                                                       
greeter-5d86321e-86f2-41a6-8230-f015466bf791    10.198.75.60:51395      broker=http,protocol=grpc,registry=mdns
,server=grpc,transport=grpc                                                                                    

Endpoint: Greeter.Hello                                                                                        

Request: {                                                                                                     
        message_state MessageState {                                                                           
                no_unkeyed_literals NoUnkeyedLiterals                                                          
                do_not_compare DoNotCompare                                                                    
                do_not_copy DoNotCopy                                                                          
                message_info MessageInfo                                                                       
        }                                                                                                      
        int32 int32                                                                                            
        unknown_fields []uint8                                                                                 
        name string                                                                                            
}                                                                                                              

Response: {                                                                                                    
        message_state MessageState {                                                                           
                no_unkeyed_literals NoUnkeyedLiterals                                                          
                do_not_compare DoNotCompare                                                                    
                do_not_copy DoNotCopy                                                                          
                message_info MessageInfo                                                                       
        }                                                                                                      
        int32 int32                                                                                            
        unknown_fields []uint8                                                                                 
        greeting string                                                                                        
}                                                                                   

注意看里面的 IP 地址,注册到了 10.198.xx 去了,因此才会报错???
因此在注册服务的时候,指定 IP 地址

go run server.go greeter.pb.go greeter.pb.micro.go --server_address=localhost:8888

这个时候再用 client 调用就不会出错了。

$ go run client.go greeter.pb.go greeter.pb.micro.go
Hello Zaun pianist
本作品采用《CC 协议》,转载必须注明作者和本文链接
讨论数量: 3
larasail

go-micro安装之路真的是坎坷,各种库版本兼容,从go1.12一路升级到1.15,依然存在问题,心态崩了 :pensive:

1周前 评论

@larasail 我用 1.15 也出错了,现在用的 1.14 版本

1周前 评论
larasail

@折戟沉沙 :joy: :joy: 看来得再试一下1.4版本了

1周前 评论

请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!