go-kit-seed/

README

PassCamp <%= appName %> microservice

Microservice that store users private and public keys.

Development best practices - (GO KIT)

Go kit is a programming toolkit for building microservices (or elegant monoliths) in Go.

Dependencies

• Docker - INSTALATION GUIDE
• docker-compose - 1.18.0
• golang/dep - go get -u github.com/golang/dep/cmd/dep
• google/protobuf - Put bin folder to /usr/local
• golang/protobuf - go get -u github.com/golang/protobuf/protoc-gen-go
• awpc-dev-stack - 1.0

Install go

How to install Go language

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go

Setup /etc/hosts file

127.0.0.1       *******
127.0.1.1       *******
127.0.0.1       *******
127.0.0.1       be-buckets.passcamp.doc
127.0.0.1       postgres
127.0.0.1       *******
127.0.1.1       *******
127.0.0.1       *******

Prepare for setup

• Create folder in $GOPATH/src/
• Install and start awpc-dev-stack

Initial Setup

$ make init

Check dependencies

$ make help

Build microservice

$ make build

How to install new dependency?

It's easy just use:

$ go get github.com/asaskevich/govalidator

Start

Make sure that awpc-dev-stack is running:

$ make start

Run single test || all tests from vscode editor

Make sure that awpc-dev-stack and be-keys microservice is running. Use vscode run test command.

Run all test in an isolated environment.

Make sure that awpc-dev-stack is running:

$ make tests

Debug

Make sure that awpc-dev-stack is running: After that use vscode debug with Remote configuration

$ make debug

Publish and deploy code.

Make sure that your account has correct permissions

$ make publish

Useful links

• GO-KIT-MICROSERVICE GENERATOR - Generate initial microservice boilerplate
• Gorm - The fantastic ORM library for Golang, aims to be developer friendly.
• govalidator - A package of validators and sanitizers for strings, structs, and collections.
• Proto-buffers - New communication protocol