Boilerplate for REST Microservice in Go

Features

• REST API and Swagger UI
• Middlewares (cors, gzip and static)
• CI with Travis
• Docker Build

Installation

Get the micro-rest repository

go get github.com/goboilerplates/micro-rest

cd echo $GOPATH/src/github.com/goboilerplates/micro-rest

And install dependencies

go get -u github.com/golang/dep/cmd/dep

dep ensure

Running the tests

Run all tests

go test ./...

Or run all tests with coverage

bash script/coverage.sh

Build and Run

Run main.go

go run main.go
# serve at localhost:9000

Build and run native binary

bash script/Build.sh

./micro-rest.out

Build native binary for multiple platforms (darwin, windows and linux)

bash script/BuildMulti.sh

Environment variables

    # enable production mode, default is false
    env GBP_PROMODE=true

Docker support

Build docker image

bash script/Dockerbuild.sh

Run docker container

docker run -d --name micro-rest -p 9000:9000 goboilerplates/micro-rest

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details