koala
koala是一个基于grpc的高并发、高性能的微服务框架，提供了非常丰富的功能。
Installation
-
Go Version >= 1.11
-
Grpc Version: google.golang.org/grpc v1.24.0
-
protoc Version >= 3.11.0, 安装地址：https://github.com/protocolbuffers/protobuf/releases
go get github.com/ibinarytree/koala go get github.com/ibinarytree/koala/tools/koala
Usage
- 生成服务端代码
hello.proto
syntax = "proto3";
package hello;
//使用go_package指定生成的代码路径，下面的代码将会生成到github.com/ibinarytree/hello/proto_gen/hello这个目录下；
//大家可以根据自己项目的目录指定这个路径
//一般建议大家把proto文件和生成的代码统一进行管理，放到一个单独的代码库中；
option go_package="github.com/ibinarytree/hello/proto_gen/hello";
message HelloRequest {
string name = 1;
}
message HelloResponse {
string reply = 1;
}
service HelloService {
//sayhello 方法
rpc SayHello(HelloRequest) returns (HelloResponse){}
}
生成代码
koala -s -f hello.proto
注意：如果hello.proto有import其他proto文件，需要通过proto_path指定引入的proto文件的目录，通过-i文件生成引入的proto文件代码。
- 生成客户端代码
koala -c -f hello.proto
- 编译，生成代码之后，执行build.sh即可以编译。window执行build.bat
./build.sh
- 运行，编译之后的二进制程序统一放到了output目录，执行output目录下的start.sh即可以启动运行。window执行start.bat
cd output
./start.sh
- 部署，把output目录打包成output.tar.gz，拷贝到服务端上，然后后台运行即可
nohup ./start.sh&
Question
- 编译时，报etcd相关错误，比如:undefined: balancer.PickOptions；是因为grpc版本和etcd不兼容导致。解决方法如下：
打开go.mod, 把grpc的版本修改成v1.24.0
require (
github.com/golang/protobuf v1.3.4
github.com/ibinarytree/koala v1.9.9
github.com/smartystreets/goconvey v1.6.4 // indirect
golang.org/x/net v0.0.0-20200301022130-244492dfa37a
google.golang.org/grpc v1.27.1
)
修改后的go.mod内容如下：
require (
github.com/golang/protobuf v1.3.4
github.com/ibinarytree/koala v1.9.9
github.com/smartystreets/goconvey v1.6.4 // indirect
golang.org/x/net v0.0.0-20200301022130-244492dfa37a
google.golang.org/grpc v1.24.0
)
重新编译，问题解决了