cherry

cherry

一个开箱即用，高度集成的微服务组件库,可以快速开发集grpc,http,graphql的云原生微服务

cherry服务器，各种服务接口的保留，集成支持，一个服务暴露grpc,http,graphql接口

• 集成opentelemetry实现调用链路跟踪记录，配合context及utils/log 实现完整的请求链路日志记录
• 集成prometheus及pprof实现性能监控及性能问题排查
• 支持框架自生成的由gin提供支持的grpc转http，也支持原生的grpc-gateway

quick start

go get github.com/hopeio/cherry

install tools

• install protochttps://github.com/protocolbuffers/protobuf/releases
• go run $(go list -m -f {{.Dir}} github.com/hopeio/protobuf)/tools/install_tools.go

generate protobuf

protogen go -e -w -v -p _example/proto -o _example/protobuf -d(openapi doc) -e(enum扩展) -w(gin gateway) -g(graphql) -v(生成校验代码) -i proto目录 -o 输出pb.go目录

use docker(可选的)

docker run --rm -v $project:/work jybl/protogen protogen go -d -e -w -i $proto_path -o $proto_output_path

run

go run _example/user/main.go

package main

import (
	"github.com/gin-gonic/gin"
	"github.com/hopeio/cherry"
	"protobuf/user"
	userservice "user/service"
	"google.golang.org/grpc"
)

func main() {

	cherry.NewServer(cherry.WithGrpcHandler(func(gs *grpc.Server) {
		user.RegisterUserServiceServer(gs, userservice.GetUserService())
	}), cherry.WithGinHandler(func(app *gin.Engine) {
		_ = user.RegisterUserServiceHandlerServer(app, userservice.GetUserService())
		app.Static("/static", "F:/upload")
	})).Run()
}

grpc-gateway

protobuf插件生成基于gin的gateway,实现基于grpc对外提供http接口

grpc-web

grpc-web集成,通过浏览器调用grpc服务

http3

通过quic实现http3的支持

可观测性

集成opentelemetry

graphql(废弃)

鉴于国内实际落地并不多，移除掉graphql支持