go-gin-webapp
Go Gin Webapp is a template project, that you can use to build your RESTful microservices using Gin in similar to this blogpost.
It defaults the configuration to use https, if you configure the paths to Certificate and Key correctly.
Gin-gomonitor provides default metrics and you can easily implement your own metrics, if you need.
It uses gin-glog middleware, which internally uses glog as logger. This provides you leveled Logs, commandline options and logs are flushed to disk in a separate goroutine with a configurable interval.
An OAuth2 middleware supports you to secure your web applications, if you need authentication and authorization.
Usage
To create a new web application, you can do the following steps
# osx need to set SED=gsed, because it uses sed -i (inplace)
make create.app APP=myapp REPO_USER=github.com/szuecs SED=gsed
The main package and function of the service is in cmd/$APP/server.go. It parses flags and merges the configuration to start the service. A client main package can be find in cmd/$APP-cli/client.go.
The api package bootstraps the http(s) microservice, middleware, registers the path specific handlers and you implement handlers (similar to Controller in MVC) there.
The client package implements a client, that calls your api endpoints.
Configuring your service and client, use the following make target:
% make config
Create a docker container from your current git tagged release, it will automatically create scm-source.json for you and you git tools to get the tagged version from your local tree:
% make build.docker
% make build.push # if you want to build and push
Create a rkt container from your current git tagged release:
% make build.rkt