- 打通grpc + gin,同时支持grpc 跟 restful 模式
- grpc , gin 公用端口
- gorm 嵌入,自动数据库代码生成
-
install
-
proto环境安装
make install
- 本地环境搭建(gmsec为例)
make gen
- 新建一个服务
make new service=[服务名]
仓库包含三个独立 module:example(主服务)、apidoc/rpc(共享 pb 代码)、
tools(脚手架)。三者各自直接构建即可,不需要 workspace(也避免与本机
go env -w GOFLAGS=-mod=mod 之类的全局设置冲突):
cd example && go build ./...
cd apidoc/rpc && go build ./...
cd tools && go build ./...
跨模块调用生成工具统一用 go -C ../tools run ./gmsecgen ...
(example/Makefile 的 proto / clean-proto 与 go generate 都走这条路径)。
生产环境的口令/地址不要写进 example/conf/config.yml,按 .env.example
通过 GMSEC_DB_PASSWORD 等环境变量注入。
syntax = "proto3"; // 指定proto版本
package proto; // 指定包名
option go_package = ".;proto"; // 指定路径
// 定义Hello服务
service Hello {
// 定义SayHello方法
rpc SayHello(HelloRequest) returns (HelloReply) {}
}
// HelloRequest 请求结构
message HelloRequest {
string name = 1; // 名字
}
// HelloReply 响应结构
message HelloReply {
string message = 1; // 消息
}
package main
import (
"context"
"fmt"
proto "gmsec/rpc/gmsec"
"github.com/gmsec/goplugins/api"
"github.com/gin-gonic/gin"
"github.com/gmsec/goplugins/plugin"
"github.com/gmsec/micro"
"github.com/xxjwxc/ginrpc"
)
func main() {
// grpc 相关 初始化服务
service := micro.NewService(
micro.WithName("lp.srv.eg1"),
)
h := new(hello)
proto.RegisterHelloServer(service.Server(), h) // 服务注册
// ----------- end
// gin 相关
base := ginrpc.New(ginrpc.WithCtx(api.NewAPIFunc), ginrpc.WithDebug(dev.IsDev()))
router := gin.Default()
v1 := router.Group("/xxjwxc/api/v1")
base.Register(v1, h) // 对象注册
// ------ end
plg, _ := plugin.Run(plugin.WithMicro(service),// grpc 入口
plugin.WithGin(router), // http 入口
plugin.WithAddr(":8080")) // 开始服务(公用端口)
plg.Wait() // 等待结束(ctrl+c)
fmt.Println("done")
}
// Ctx gin.Context 到 context.Context 的转换
func Ctx(c *gin.Context) interface{} {
return context.Background()
}package main
import (
"context"
"fmt"
proto "gmsec/rpc/gmsec"
"github.com/gmsec/micro"
)
func main() {
// reg := registry.NewDNSNamingRegistry()
// grpc 相关 注册服务发现等
micro.NewService(
micro.WithName("lp.srv.eg1"),
// micro.WithRegisterTTL(time.Second*30), //指定服务注册时间
// micro.WithRegisterInterval(time.Second*15), //让服务在指定时间内重新注册
// micro.WithRegistryNaming(reg),
)
// ----------- end
say := proto.GetHelloClient()
ctx := context.Background()
resp, _ := say.SayHello(ctx, &proto.HelloRequest{Name:"xxjwxc"})
fmt.Println("result:", resp)
}更多示例 => 传送门
- etcdv3