Exemplary RESTFul API built with go, gin, gorm
This project is an exemplary rest api server built with Go :)
See API Spec (modified from RealWorld API Spec to simplify)
API Server technology stack is
golang
gin
MySQL
with golang-migrate
to migrategorm v2
fx
go test
and testify
cobra
Getting started
build a docker image
// docker build -f cmd/server/Dockerfile -t gin-example/article-server .
$ make build-docker
run api server with mysql (see docker-compose.yaml)
// docker-compose up --force-recreate
$ make compose.up
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e01564708984 gin-example/article-server "article-server --co…" 40 seconds ago Up 39 seconds 0.0.0.0:3000->3000/tcp article-server
105cb25b6d3a mysql:8.0.17 "docker-entrypoint.s…" 40 seconds ago Up 39 seconds 0.0.0.0:3306->3306/tcp, 33060/tcp my-mysql
$ make compose.down
Check apis
Run intellij's .http files in tools/http/sample directory
(./tools/http/sample)