MorningGo : Gin WebApp Project Skeleton

中文文档

A Web develop project skeleton base on Gin which just for reference.

More efficiency,
Faster and clear,
Easier to deploy

Suitable for simple project. ko、kit、go-micro、kite are better choice for the middle and large project.

Environment Requirements

GO >= 1.8

Installation And Run

Via moroingo installer or use docker

Install

go get github.com/chenhg5/morningo-installer
cd $GOPATH/src
$GOPATH/bin/morningo-installer --project-name web

Load Dependency

cd web
make deps

Test

make test

Graceful Restart

make restart

Run It

make

visit by browser: http://localhost:4000/api/index

Deploy

First build the executable file

make build # for Linux
make cross # for mac/windows

Then put files of the build in your server and set the path of log and static file(html/css/js),and run the executable file.If 80 port is not allowed to use,consider the nginx proxy,or use the gin middleware gin-reverseproxy instead, which has some example in routers.go. When the project start running, it will generate the pidfile in the root path of the project. Excute the following command to update your project.

kill -INT $(cat pid) && ./morningo # graceful stop the process and restart

Project Structure


.
├── Makefile
├── README.md
├── cli                     
│   └── cli.go
├── config                      global config
│   ├── connections.go
│   ├── cookie.go
│   ├── jwt.go
│   └── env.go
├── connections                 store connection
│   ├── database
│   │   ├── mongodb
│   │   └── mysql
│   └── redis
│       └── redis.go
├── controllers                 controller
│   └── MainController.go
├── filters                     middleware
│   ├── auth                    auth middleware
│   │   ├── drivers             auth engine
│   │   └── auth.go   
│   └── filter.go               middleware initer                  
├── frontend                    frontend resource
│   ├── assets
│   │   ├── css
│   │   ├── images
│   │   └── js
│   ├── dist
│   └── templates
│       └── index.tpl
├── handle.go                   global error handler
├── main.go                     
├── models                      model
│   └── User.go
├── module                      module of project
│   │── schedule
│   │   └── schedule.go   
│   │── logger
│   │   └── logger.go 
│   └── server
│       └── server.go 
├── routers                     routers
│   └── api_routers.go       
├── routers.go                  router initer
├── routers_test.go             unit test for api
├── storage                     
│   ├── cache                   cache file
│   └── logs                    log file
│       ├── access.log 
│       ├── info.log          
│       └── error.log
└── vendor                      govendor vendor

What`s in the box

HTTP (based on Gin)

Router
Middleware
Controller
Request
Response
View
Session

Frontend

Go template

Security

Authentication
Authorization
Encryption
Hash

Digging Deeper

Dancer Command
Cache System
Error and Log
Schedule

Database

Mysql
Mongodb
Redis

ORM(based on gorm)

test

Api test

Example

https://github.com/chenhg5/morningo/blob/master/controllers/MainController.go

Project Dependency

web framework：github.com/gin-gonic/gin
orm：github.com/jinzhu/gorm
redis：github.com/go-redis/redis
mysql：github.com/go-sql-driver/mysql
wechat：github.com/silenceper/wechat
schedule：github.com/robfig/cron

Benchmark

wrk -c100 -d30s -t4 http://localhost:4000/api/index

Running 30s test @ http://localhost:4000/api/index
  4 threads and 100 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency     4.03ms    4.17ms  72.72ms   89.95%
    Req/Sec     7.40k     1.67k   11.20k    67.75%
  884816 requests in 30.03s, 107.17MB read
  Non-2xx or 3xx responses: 884816
Requests/sec:  29462.96
Transfer/sec:  3.57MB

TODO

ChangeLog

Add Reverse Proxy
Fixed the path
Add session/cache and Auth middleware
Add test
Add graceful restart
Add schedule module
Add installer of project
Add access.log and error.log
Add database transcation