goboot

README

GOBOOT

概述

GOBOOT 是一个可以用来开http，gRPC和自定义游戏服务器的Golang脚手架。

特性

• 高性能分布式服务器开发
• 支持gRPC开发微服务
• 支持http的API开发
• 支持游戏服务器网关开发，支持tcp，kcp，websocket协议
• 提供了bootctl作为，项目管理和代码生成工具

快速开始

使用bootctl

goboot推荐使用bootctl命令行工具，来生成代码结构和代码，方便在多人开发时，控制编码规范。具体参考。

一个规范的目录结构如下:

├─bin                             # build之后的发布包
├─cmd                             # 自定义的命令行工具
├─configs                         # 所有的配置文件
├─docs                            # 项目相关文档
|  ├─devel                        # 开发相关文档，如接口描述
│  └─guide                        # 教程相关文档
├─example                         # 一些小示例，或测试demo
├─internal                        # 业务代码
│  ├─api                          # 应用程序接口，http和game
│  │  ├─gameserver
│  │  │  └─gateway
│  │  └─helloworld
│  │      └─user
│  ├─pb                           # protbuf生成库
│  │  └─proto                     # .proto文件
│  └─service                      # 服务
│      └─user
│          ├─client
│          └─server
├─logs                            # 日志
│  └─Gateway
└─pkg                             # 公共包

详情请查阅参考文件

惯例

开发能够遵循一些管理来实现，这样可以大部分减少描述的篇幅，遵循惯例，也方便多人开发的协作。因此，推崇一下惯例：

1. 所有实例的配置文件都放在根目录下的configs目录
2. 所有实例的配置文件中，设定日志配置条件

# 日志配置
Logger:
  # 日志输出级别，debug->info->warn->error
  Level: "debug"
  # 日志文件的输出分类，文件名是 {target}_{instanceId}.log
  Target: "gameserver.api"
  # 日志输文件夹
  Outpath: "./logs"

1. 所有api接口的实现，都需要参考Module实现模块化
2. 所有service的实现，必须通过protobuff定义gRPC实现
3. 其他惯例，可以参考示例中的参考实现

参考

• Game Server: 游戏服
• HTTP API: http开发Api接口
• Service: gRPC微服务
• bootctl：命令行工具

关联项目

• goboot-csharp-client: gamapi的C#客户端实现，可用于unity开发

打赏作者