zqhong / albedo

Gin Api Project Skeleton

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Albedo: Gin Api Project Skeleton

s-2a.png

基于 Gin 的 API 开发框架

使用的包

辅助库/组件

  • 包依赖管理:go mod
  • Makefile:内置快速使用的命令

安装

# 1、克隆当前项目到本地
$ git clone git@github.com:zqhong/albedo.git

# 2、打开 Makefile,修改 PROJECT_NAME 为你的项目名称,例如:github.com/zqhong/demo233

# 3、修改配置文件 conf/config.yaml

# 4、执行最后到安装处理
$ make install

# 5、测试
# 如果启动失败,检查 runtime/albedo.log 日志文件
$ ./build/web
$ ./build/cli

新建命令

# 新产生的文件在 cmd 目录下
# 重新编译 cli 之后,使用 ./build/albedo-cli 即可看到新命令的帮助提示
$ cobra add [command name]

Makefile 内置命令

# 同时编译 web 和 cli
$ make build

$ make build-web
$ make build-cli

$ make run-web
$ make -run-cli

$ make test

$ make clean

admin.sh 内置命令

$ bash admin.sh start

$ bash admin.sh stop

$ bash admin.sh status

目录结构

├── admin.sh                     # 进程管理脚本(start/stop/restart/status)
├── app                          # 进程启动 && 服务初始化代码
│   ├── boot.go                  # 进程启动代码
│   ├── config.go                # 配置服务初始化
│   ├── db.go                    # db 服务初始化
│   ├── gin.go                   # gin 服务初始化
│   ├── logger.go                # logger 服务初始化
├── build                        # 存放编译后的二进制文件
├── conf                         # 配置文件存储目录
│   ├── config.yaml              # 配置文件
├── cronjob                      # 任务调度相关
├── handler                      # MVC 架构中的 C
│   ├── handler.go
│   ├── sd                       # 健康检查handler
│   │   └── check.go
├── model                        # MVC 架构中的 M
├── pkg                          # 引用的包
├── router                       # 路由相关处理
├── runtime                      # 存放临时文件,如日志、pid 文件
├── util                         # 工具类函数存放目录
└── vendor                       # vendor目录用来管理依赖包

logger 的使用

参考:https://beego.me/docs/module/logs.md

缓存模块的使用

参考:https://beego.me/docs/module/cache.md

任务调度的使用

import (
	"github.com/robfig/cron"
	"fmt"
)

c := cron.New()

c.AddFunc("@hourly", func() {
    fmt.Println("hourly call")
})

c.Start()

待完成

  • 添加测试
  • 文档支持(Swagger)
  • 多数据库驱动支持
  • 进程级缓存(MemCache)
  • 任务调度(crontab)

参考

About

Gin Api Project Skeleton

License:MIT License


Languages

Language:Go 84.9%Language:Makefile 8.9%Language:Shell 6.2%