Populate new fabric8-services/fabric8-starter repository with sample service

[stooke]

This repository contains a small skeleton Fabric8 service that starts and provides a few required endpoints for service readines and metrics. Wherever possible, it uses fabric8-services/fabric8-common packages to implement functionality.

Contents of this repository are anticipated to include:

Build

Dependency management
Goa code generation
Docker
Tests
common target names
Database

Database migration
local Docker instance
Dev tools

Debugging
Dev / prod-preview / production
Documentation

What this template service actually does and how it's put together
How this service uses the common code
Coding idioms encouraaged within fabric8-services

[stooke]

@aslakknutsen has a suggestion for various levels of app - hopefully the repo will allow this:

1. Basic service

   1. build scripts
   2. docker file(s)

2. Basic k8 service

   1. readiness endpoint
   2. health endpoint
   3. json based console logging
   4. error reporting to sentry
   5. metrics exposure for prometheus
   6. ops abillity (gops) for runtime inspection
   7. tracing ability via e.g. Opentracing (comming)
   8. deployment templates
   9. env configuration

3. Basic osio service

   1. api http endpoint
   2. service http clients
   3. event bus connection for publish / receive

4. Osio service

   1. Service login with Auth
   2. Public keys from Auth (with auto refresh)

5. Osio 'some what common'

   1. Cluster API (with auto refresh)
   2. Cluster Token Decode

6. Osio service business logic

   1. xxx, what ever the 'thing' is intended to do

[joshuawilson]

Please add labels. Is this a task or user-story?

[stooke]

I think it's a task.