gRPC是一个高性能、通用的开源 RPC 框架,其由 Google 主要面向移动应用开发并基于HTTP/2协议标准而设计,基于ProtoBuf(Protocol Buffers)序列化协议开发,且支持众多开发语言。
g rpc 提供了一种简单的方法来精确地定义服务和为iOS、Android和后台支持服务自动生成可靠性很强的客户端功能库。
客户端充分利用高级流和链接功能,从而有助于节省带宽、降低的TCP链接次数、节省 CPU 使用、和电池寿命。
gRPC具有以下重要特征:
- 强大的 IDL 特性
RPC使用 protobuf 来定义服务, ProtoBuf 是由Google开发的一种数据序列化协议,性能出众,得到了广泛的应用。 - 支持多种语言
支持C++、 Java 、 Go 、Python、 Ruby 、C#、Node.js、Android Java、Objective-C、PHP等编程语言。 - 基于HTTP/2标准设计
gRPC已经应用在Google的云服务和对外提供的API中。
我们以 gRPC-go 为例介绍一下gRPC的开发。
首先下载相应的库:
go get google.golang.org/grpc
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
同时保证按照Protocol Buffers v3 编译器到你的 开发环境 中(protoc)。
定义你的protobuf文件 (helloworld.proto):
syntax = "proto3";
option java_package = "com.colobu.rpctest";
package greeter;
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (Hello Request ) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
这个文件定义了一个 Greeter 服务,它有一个 SayHello 方法,这个方法接收一个Request,返回一个Response。
然后我们可以编译这个文件,生成服务器和客户端的 stub :
protoc -I protos protos/helloworld.proto --go_out=plugins=grpc:src/greeter
因为上面我们安装了 proto 和 protoc-gen-go ,所以 protoc 可以生成响应的Go代码。
然后我们就可以利用这个生成的代码创建服务器代码和客户端代码了。
服务器端的代码如下:
package main
import (
"log"
"net"
pb "greeter"
"golang.org/x/net/context"
"google. go lang.org/grpc"
)
const (
port = ":50051"
)
type server struct {}
// SayHello implements helloworld.GreeterServer
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
return &pb.HelloReply{Message: "Hello " + in.Name}, nil
}
func main() {
lis, err := net.Listen("tcp", port)
if err != nil {
log.Fatalf("failed to listen: %v", err )
}
s := grpc.NewServer()
pb.RegisterGreeterServer(s, &server{})
s.Serve(lis)
}
客户端的测试代码如下:
package main
import (
"fmt"
"log"
"os"
" strconv "
"sync"
"time"
pb "greeter"
"golang.org/x/net/context"
"google.golang.org/grpc"
)
const (
address = "localhost:50051"
defaultName = "world"
)
func invoke(c pb.GreeterClient, name string) {
r, err := c.SayHello(context.Background(), &pb.HelloRequest{Name: name})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
_ = r
}
func syncTest(c pb.GreeterClient, name string) {
i := 10000
t := time.Now(). Unix Nano()
for ; i>0; i-- {
invoke(c, name)
}
fmt.Println("took", (time.Now().UnixNano() - t) / 1000000, " ms ")
}
func asyncTest(c [20]pb.GreeterClient, name string) {
var wg sync.WaitGroup
wg.Add(10000)
i := 10000
t := time.Now().UnixNano()
for ; i>0; i-- {
go func() {invoke(c[i % 20], name);wg.Done()}()
}
wg.Wait()
fmt.Println("took", (time.Now().UnixNano() - t) / 1000000, "ms")
}
func main() {
// Set up a connection to the server.
conn, err := grpc.Dial(address)
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
var c [20]pb.GreeterClient
// Contact the server and print out its response.
name := defaultName
sync := true
if len(os.Args) > 1 {
sync, err = strconv.ParseBool(os.Args[1])
}
//warm up
i := 0
for ; i < 20; i++ {
c[i] = pb.NewGreeterClient(conn)
invoke(c[i], name)
}
if sync {
syncTest(c[0], name)
} else {
asyncTest(c, name)
}
}
服务注册中心
服务注册中心用来实现服务发现和服务的元数据存储。
当前rpcx支持多种注册中心, 并且支持进程内的注册中心,方便开发测试。
rpcx会自动将服务的信息比如服务名,监听地址,监听协议,权重等注册到注册中心,同时还会定时的将服务的吞吐率更新到注册中心。
如果服务意外中断或者宕机,注册中心能够监测到这个事件,它会通知客户端这个服务目前不可用,在服务调用的时候不要再选择这个服务器。
客户端初始化的时候会从注册中心得到服务器的列表,然后根据不同的路由选择选择合适的服务器进行服务调用。 同时注册中心还会通知客户端某个服务暂时不可用。
通常客户端会选择一个服务器进行调用。
下面看看不同的注册中心的使用情况。
Peer2Peer {#peer2peer}
点对点是最简单的一种注册中心的方式,事实上没有注册中心,客户端直接得到唯一的服务器的地址,连接服务。在系统扩展时,你可以进行一些更改,服务器不需要进行更多的配置
客户端使用 Peer2PeerDiscovery 来设置该服务的网络和地址。
由于只有有一个节点,因此选择器是不可用的。
d := client.NewPeer2PeerDiscovery("tcp@"+*addr, "")
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
注意:rpcx使用 network @ Host: port 格式表示一项服务。在 network 可以 tcp , http , unix , quic 或 kcp 。该 Host 可以所主机名或IP地址。
NewXClient 必须使用服务名称作为第一个参数,然后使用failmode,selector,discovery和其他选项。
MultipleServers {#multiple}
上面的方式只能访问一台服务器,假设我们有固定的几台服务器提供相同的服务,我们可以采用这种方式。
如果你有多个服务但没有注册中心.你可以用编码的方式在客户端中配置服务的地址。
服务器不需要进行更多的配置。
客户端使用 MultipleServersDiscovery 并仅设置该服务的网络和地址。
d := client.NewMultipleServersDiscovery([]*client.KVPair{{Key: *addr1}, {Key: *addr2}})
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
你必须在MultipleServersDiscovery 中设置服务信息和元数据。如果添加或删除了某些服务,你可以调用 MultipleServersDiscovery.Update 来动态更新服务。
func (d *MultipleServersDiscovery) Update(pairs []*KVPair)
ZooKeeper {# zookeeper }
Apache ZooKeeper是Apache软件基金会的一个软件项目,他为大型分布式计算提供开源的分布式配置服务、同步服务和命名注册。 ZooKeeper曾经是 Hadoop 的一个子项目,但现在是一个独立的顶级项目。
ZooKeeper的架构通过冗余服务实现高可用性。因此,如果第一次无应答,客户端就可以询问另一台ZooKeeper主机。ZooKeeper节点将它们的数据存储于一个分层的命名空间,非常类似于一个文件系统或一个 前缀树 结构。客户端可以在节点读写,从而以这种方式拥有一个共享的配置服务。更新是全序的。
使用ZooKeeper的公司包括 Rackspace 、雅虎和 eBay ,以及类似于象 Solr 这样的开源企业级搜索系统。
ZooKeeper Atomic Broadcast (ZAB)协议是一个类似 Paxos 的协议,但也有所不同。
Zookeeper一个应用场景就是服务发现,这在Java生态圈中得到了广泛的应用。Go也可以使用Zookeeper,尤其是在和Java项目混布的情况。
服务器
基于rpcx用户的反馈, rpcx 3.0进行了重构,目标之一就是对rpcx进行简化, 因为有些用户可能只需要zookeeper的特性,而不需要etcd、consul等特性。rpcx解决这个问题的方式就是使用 tag ,需要你在编译的时候指定所需的特性的 tag 。
比如下面这个例子, 需要加上 -tags zookeeper 这个参数, 如果需要多个特性,可以使用 -tags “tag1 tag2 tag3” 这样的参数。
服务端使用Zookeeper唯一的工作就是设置 ZooKeeperRegisterPlugin 这个插件。
它主要配置几个参数:
- ServiceAddress: 本机的监听地址, 这个对外暴露的监听地址, 格式为 tcp@ipaddress:port
- ZooKeeperServers: Zookeeper集群的地址
- BasePath: 服务前缀。 如果有多个项目同时使用zookeeper,避免命名冲突,可以设置这个参数,为当前的服务设置命名空间
- Metrics: 用来更新服务的TPS
- UpdateInterval: 服务的刷新间隔, 如果在一定间隔内(当前设为2 * UpdateInterval)没有刷新,服务就会从Zookeeper中删除
需要说明的是:插件必须在注册服务之前添加到Server中,否则插件没有办法获取注册的服务的信息。
// go run -tags zookeeper server.go
func main() {
flag.Parse()
s := server.NewServer()
add Registry Plugin(s)
s.RegisterName("Arith", new(example.Arith), "")
s.Serve("tcp", *addr)
}
func addRegistryPlugin(s *server.Server) {
r := &serverplugin.ZooKeeperRegisterPlugin{
ServiceAddress: "tcp@" + *addr,
ZooKeeperServers: []string{*zkAddr},
BasePath: *basePath,
Metrics: metrics.NewRegistry(),
UpdateInterval: time.Minute,
}
err := r.Start()
if err != nil {
log.Fatal(err)
}
s.Plugins.Add(r)
}
客户端
客户端需要设置 ZookeeperDiscovery , 指定 basePath 和zookeeper集群的地址。
// go run -tags zookeeper client.go
d := client.NewZookeeperDiscovery(*basePath, "Arith",[]string{*zkAddr}, nil)
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
Etcd {#etcd}
Example: etcd
etcd 是 CoreOS 团队于 2013 年 6 月发起的开源项目,它的目标是构建一个高可用的分布式键值(key-value)数据库,基于 Go 语言实现。我们知道,在 分布式系统 中,各种服务的配置信息的管理分享,服务的发现是一个很基本同时也是很重要的问题。CoreOS 项目就希望基于 etcd 来解决这一问题。
因为是用Go开发的,在Go的生态圈中得到广泛的应用。当然,因为etcd提供了RESTful的接口,其它语言也可以使用。
etcd registry使用和zookeeper非常相像。
编译的时候需要加上 etcd tag。
服务器
服务器需要增加 EtcdRegisterPlugin 插件, 配置参数和Zookeeper的插件相同。
它主要配置几个参数:
- ServiceAddress: 本机的监听地址, 这个对外暴露的监听地址, 格式为 tcp@ipaddress:port
- EtcdServers: etcd集群的地址
- BasePath: 服务前缀。 如果有多个项目同时使用zookeeper,避免命名冲突,可以设置这个参数,为当前的服务设置命名空间
- Metrics: 用来更新服务的TPS
- UpdateInterval: 服务的刷新间隔, 如果在一定间隔内(当前设为2 * UpdateInterval)没有刷新,服务就会从etcd中删除
再说明一次:插件必须在注册服务之前添加到Server中,否则插件没有办法获取注册的服务的信息。以下的插件相同,就不赘述了
// go run -tags etcd server.go
func main() {
flag.Parse()
s := server.NewServer()
addRegistryPlugin(s)
s.RegisterName("Arith", new(example.Arith), "")
s.Serve("tcp", *addr)
}
func addRegistryPlugin(s *server.Server) {
r := &serverplugin.EtcdRegisterPlugin{
ServiceAddress: "tcp@" + *addr,
EtcdServers: []string{*etcdAddr},
BasePath: *basePath,
Metrics: metrics.NewRegistry(),
UpdateInterval: time.Minute,
}
err := r.Start()
if err != nil {
log.Fatal(err)
}
s.Plugins.Add(r)
}
客户端
客户端需要设置 EtcdDiscovery 插件,设置 basepath 和etcd集群的地址。
// go run -tags etcd client.go
d := client.NewEtcdDiscovery(*basePath, "Arith",[]string{*etcdAddr}, nil)
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
Consul {#consul}
Example: consul
Consul是HashiCorp公司推出的开源工具,用于实现分布式系统的服务发现与配置。Consul是分布式的、高可用的、 可横向扩展的。它具备以下特性:
- 服务发现: Consul提供了通过DNS或者HTTP接口的方式来注册服务和发现服务。一些外部的服务通过Consul很容易的找到它所依赖的服务。
- 健康检测: Consul的Client提供了健康检查的机制,可以通过用来避免流量被转发到有故障的服务上。
- Key/Value存储: 应用程序可以根据自己的需要使用Consul提供的Key/Value存储。 Consul提供了简单易用的HTTP接口,结合其他工具可以实现动态配置、功能标记、领袖选举等等功能。
- 多数据中心: Consul支持开箱即用的多数据中心. 这意味着用户不需要担心需要建立额外的抽象层让业务扩展到多个区域。
Consul也是使用Go开发的,在Go生态圈也被广泛应用。
使用 consul 需要添加 consul tag。
服务器
服务器端的开发和zookeeper、consul类似。
需要配置 ConsulRegisterPlugin 插件。
它主要配置几个参数:
- ServiceAddress: 本机的监听地址, 这个对外暴露的监听地址, 格式为 tcp@ipaddress:port
- ConsulServers: consul集群的地址
- BasePath: 服务前缀。 如果有多个项目同时使用zookeeper,避免命名冲突,可以设置这个参数,为当前的服务设置命名空间
- Metrics: 用来更新服务的TPS
- UpdateInterval: 服务的刷新间隔, 如果在一定间隔内(当前设为2 * UpdateInterval)没有刷新,服务就会从consul中删除
// go run -tags consul server.go
func main() {
flag.Parse()
s := server.NewServer()
addRegistryPlugin(s)
s.RegisterName("Arith", new(example.Arith), "")
s.Serve("tcp", *addr)
}
func addRegistryPlugin(s *server.Server) {
r := &serverplugin.ConsulRegisterPlugin{
ServiceAddress: "tcp@" + *addr,
ConsulServers: []string{*consulAddr},
BasePath: *basePath,
Metrics: metrics.NewRegistry(),
UpdateInterval: time.Minute,
}
err := r.Start()
if err != nil {
log.Fatal(err)
}
s.Plugins.Add(r)
}
客户端
配置 ConsulDiscovery ,使用 basepath 和consul的地址。
d := client.NewConsulDiscovery(*basePath, "Arith",[]string{*consulAddr}, nil)
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
mDNS {#mdns}
Example: mDNS
mdns 即多播dns(Multicast DNS),mDNS主要实现了在没有传统DNS服务器的情况下使局域网内的主机实现相互发现和通信,使用的端口为5353,遵从dns协议,使用现有的DNS信息结构、名语法和资源记录类型。并且没有指定新的操作代码或响应代码。
在局域网中,设备和设备之前相互通信需要知道对方的ip地址的,大多数情况,设备的ip不是静态ip地址,而是通过dhcp 协议动态分配的ip 地址,如何设备发现呢,就是要mdns大显身手,例如:现在物联网设备和app之间的通信,要么app通过广播,要么通过组播,发一些特定信息,感兴趣设备应答,实现局域网设备的发现,当然服务也一样。
mDns协议规定了消息的基本格式和消息的收发的基本顺序,DNS-SD 协议在这基础上,首先对实例名,服务名称,域名长度/顺序等作出了具体的定义,然后规定了如何方便地进行服务发现和描述。
服务实例名称 = <服务实例>.<服务类型>.<域名>
服务实例一般由一个或多个标签组成,标签之间用 . 隔开。
服务类型表明该服务是使用什么协议实现的,由 _ 下划线和服务使用的协议名称组成,如大部分使用的 _tcp 协议,另外,可以同时使用多个协议标签,如: “_http._tcp” 就表明该服务类型使用了基于tcp的http协议。
域名一般都固定为 “local”
DNS-SD 协议使用了PTR、SRV、TXT 3种类型的资源记录来完整地描述了一个服务。当主机通过查询得到了一个PTR响应记录后,就获得了一个它所关心服务的实例名称,它可以同通过继续获取 SRV 和 TXT 记录来拿到进一步的信息。其中的 SRV 记录中有该服务对应的主机名和端口号。TXT 记录中有该服务的其他附加信息。
服务器
func main() {
flag.Parse()
s := server.NewServer()
addRegistryPlugin(s)
s.RegisterName("Arith", new(example.Arith), "")
s.Serve("tcp", *addr)
}
func addRegistryPlugin(s *server.Server) {
r := serverplugin.NewMDNSRegisterPlugin("tcp@"+*addr, 8972, metrics.NewRegistry(), time.Minute, "")
err := r.Start()
if err != nil {
log.Fatal(err)
}
s.Plugins.Add(r)
}
客户端
func main() {
flag.Parse()
d := client.NewMDNSDiscovery("Arith", 10*time.Second, 10*time.Second, "")
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
args := &example.Args{
A: 10,
B: 20,
}
reply := &example.Reply{}
err := xclient.Call(context.Background(), "Mul", args, reply)
if err != nil {
log.Fatalf("failed to call: %v", err)
}
log.Printf("%d * %d = %d", args.A, args.B, reply.C)
}
Inprocess {#inprocess}
Example: inprocess
这个Registry用于进程内的测试。 在开发过程中,可能不能直接连接线上的服务器直接测试,而是写一些mock程序作为服务,这个时候就可以使用这个registry, 测试通过在部署的时候再换成相应的其它registry.
在这种情况下, client和server并不会走TCP或者UDP协议,而是直接进程内方法调用,所以服务器代码是和client代码在一起的。
复制代码func main() {
flag.Parse()
s := server.NewServer()
addRegistryPlugin(s)
s.RegisterName("Arith", new(example.Arith), "")
go func() {
s.Serve("tcp", *addr)
}()
d := client.NewInprocessDiscovery()
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
args := &example.Args{
A: 10,
B: 20,
}
for i := 0; i < 100; i++ {
reply := &example.Reply{}
err := xclient.Call(context.Background(), "Mul", args, reply)
if err != nil {
log.Fatalf("failed to call: %v", err)
}
log.Printf("%d * %d = %d", args.A, args.B, reply.C)
}
}
func addRegistryPlugin(s *server.Server) {
r := client.InprocessClient
s.Plugins.Add(r)
}