Skip to content
/ qsf Public
forked from chuangyou/qsf

qsf是基于GRPC生态圈打造的一个简单、易用、功能强大的服务治理框架。

Notifications You must be signed in to change notification settings

byf6663/qsf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QSF - 服务治理框架


QSF是基于GRPC生态圈打造的一个简单、易用、功能强大的服务治理框架。

  • 简单易用 易于入门,易于开发,易于集成,,易于发布,易于监控。
  • 高性能 基于GRPC(HTTP2、Protocol Buffer)高性能传输。
  • 跨平台、多语言 由于采用GRPC,即可很容易部署在Windows/Linux/MacOS等平台,同时也支持各种编程语言的调用。
  • 服务发现 除了直连外,目前支持ETCD注册中心。
  • 服务治理 目前支持随机、轮询、权重等负载均衡算法,支持限流、熔断、降级等服务保护手段,支持基于prometheus实现的服务监控(可用grafana展示以及做告警),支持基于opentracing实现的服务调用链追踪。
  • API网关 目前接入GRPC生态圈的GRPC-GATEWAY。

快速开始

1、安装GRPC-GO

go get -u google.golang.org/grpc

2、安装ProtocolBuffers

mkdir tmp
cd tmp
git clone https://github.com/google/protobuf
cd protobuf
./autogen.sh
./configure
make
make check
sudo make install

3、安装proto,protoc-gen-go

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

4、安装GRPC-API-GATEWAY(需要网关就必须安装此依赖)

go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway
go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger

5、安装QSF

go get github.com/chuangyou/qsf

6、hellowolrd(GRPC服务例子)

proto:

syntax = "proto3";

option java_multiple_files = true;
option java_package = "io.grpc.examples.helloworld";
option java_outer_classname = "HelloWorldProto";

package helloworld;

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) 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;
}

server:

package main

import (
	"log"
	"net"

	"golang.org/x/net/context"
	"google.golang.org/grpc"
	pb "google.golang.org/grpc/examples/helloworld/helloworld"
	"google.golang.org/grpc/reflection"
)

const (
	port = ":50051"
)

// server is used to implement helloworld.GreeterServer.
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{})
	// Register reflection service on gRPC server.
	reflection.Register(s)
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

client:

package main

import (
	"log"
	"os"
	"time"

	"golang.org/x/net/context"
	"google.golang.org/grpc"
	pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

const (
	address     = "localhost:50051"
	defaultName = "world"
)

func main() {
	// Set up a connection to the server.
	conn, err := grpc.Dial(address, grpc.WithInsecure())
	if err != nil {
		log.Fatalf("did not connect: %v", err)
	}
	defer conn.Close()
	c := pb.NewGreeterClient(conn)

	// Contact the server and print out its response.
	name := defaultName
	if len(os.Args) > 1 {
		name = os.Args[1]
	}
	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()
	r, err := c.SayHello(ctx, &pb.HelloRequest{Name: name})
	if err != nil {
		log.Fatalf("could not greet: %v", err)
	}
	log.Printf("Greeting: %s", r.Message)
}

6、QSF和GRPC结合的例子(后续将陆续更新)

About

qsf是基于GRPC生态圈打造的一个简单、易用、功能强大的服务治理框架。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 97.5%
  • JavaScript 1.2%
  • Makefile 1.1%
  • Other 0.2%