go-micro是一种可插拔的RPC分布式系统微服务开发框架,这一章主要介绍一下入门的相关内容。
服务发现依赖项
首先 micro 这个框架需要且依赖于服务发现工具(service discovery),框架默认的服务发现工具是 Consul ,同时框架的插拔机制也可确保能够切换到其他的服务发现工具上,如Etcd、NATS等,详见 micro plugins;
关于consul的安装与运行:
$ brew install consul # 安装
$ consul agent -dev # 运行
gRPC的安装
由于 micro 框架基于 gRPC,故需要安装相关依赖项,同时安装时确保 go version 版本在1.6以上;
安装gRPC
$ go get -u google.golang.org/grpc
安装Protocol Buffers v3
安装用于生成gRPC服务代码的protoc编译器工具;
最简单的方式是通过在protobuf工具文件列表中,以查看protoc-<version>-<platform>.zip文件名格式的方式找出符合你当前版本及系统平台的安装包,找到后下载解压放置于bin目录、修改环境变量PATH等;
同时安装protoc go插件
$ go get -u github.com/golang/protobuf/protoc-gen-go
Micro相关安装
框架包的安装
$ go get github.com/micro/go-micro
protoc micro插件安装
用于通过.proto文件生成.micro.go代码文件
$ go get github.com/micro/protoc-gen-micro
micro工具包的安装
$ go get github.com/micro/micro
micro 命令行工具可以提供诸如服务列表查看、服务详情查看、调用服务接口等功能;
实践一下
首先,创建一个user.proto结构文件
syntax = "proto3";
service User {
rpc Hello(Request) returns (Response) {}
}
message Request {
string name = 1;
}
message Response {
string msg = 1;
}
其次,通过proto文件编译生成代码
protoc --proto_path=$GOPATH/src:. --micro_out=. --go_out=. user.proto
此时,通过protoc工具对user.proto文件的编译,生成了两个go文件:
- user.micro.go
- user.pb.go
然后,分别编写服务端及客户端代码
服务端 service.go
package main
import (
"context"
"fmt"
proto "github.com/JiangInk/coin_exchange/ms-user/proto"
micro "github.com/micro/go-micro"
)
type User struct{}
func (u *User) Hello(ctx context.Context, req *proto.Request, res *proto.Response) error {
res.Msg = "Hello " + req.Name
return nil
}
func main() {
service := micro.NewService(
micro.Name("user"),
)
service.Init()
proto.RegisterUserHandler(service.Server(), new(User))
if err := service.Run(); err != nil {
fmt.Println(err)
}
}
客户端 client.go
package main
import (
"context"
"fmt"
proto "github.com/JiangInk/coin_exchange/ms-user/proto"
micro "github.com/micro/go-micro"
)
func main() {
service := micro.NewService(micro.Name("user.client"))
service.Init()
user := proto.NewUserService("user", service.Client())
res, err := user.Hello(context.TODO(), &proto.Request{Name: "World ^_^"})
if err != nil {
fmt.Println(err)
}
fmt.Println(res.Msg)
}
最后,运行起来
首先启动服务发现
$ consul agent -dev
可通过访问:http://127.0.0.1:8500/ui/ 查看服务;
启动服务端程序
$ go run service.go
此时刷新:http://127.0.0.1:8500/ui/ 页面会发现新服务user;
执行客户端程序,调用接口
$ go run client.go