Skip to content

isaiah/go-micro-services

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Attention

This is a fork, so it's not go get-able, you'll have to setup the project structure as the original, e.g.

git clone https://github.com/isaiah/go-micro-services.git $GOPATH/src/github.com/harlow/

HTTP up front, Protobufs in the rear.

An demonstration of Golang micro-services that accept HTTP/JSON requests at API level and then leverage gRPC for inter-service communication.

new_sequence

The API Endpoint accepts HTTP requests on port 5000 and then spawns a number of RPC requests to the backend services.

Note: Data for each of the services is stored in JSON flat files under the /data/ directory. In reality each of the services could choose their own specialty datastore. The Geo service for example could use PostGis or any other database specializing in geospacial queries.

Installation

Protobuf v3 are required:

$ brew install protobuf --devel

Install the protoc-gen libraries:

$ go get -u github.com/golang/protobuf/{proto,protoc-gen-go}

Clone the repository:

$ git clone git@github.com:harlow/go-micro-services.git

If changes are made to the Protocol Buffers a Make file can be used to regenerate:

$ make -s

Bootstrap the services

To make the demo as straigforward as possible; docker is used to run all the services. In a production environment each of the services would be run (and scaled) independently.

make build
docker-compose up

Curl the endpoint with an invalid auth token:

$ curl http://localhost:5000 -H "Authorization: Bearer INVALID_TOKEN"
Unauthorized

Curl the endpoint without checkin or checkout dates:

$ curl "http://localhost:5000?inDate=2015-04-09" -H "Authorization: Bearer VALID_TOKEN"
Please specify outDate

Curl the API endpoint with a valid auth token:

$ curl "http://localhost:5000?inDate=2015-04-09&outDate=2015-04-10" -H "Authorization: Bearer VALID_TOKEN"

The JSON response:

{
    "hotels": [
        {
            "id": 1,
            "name": "Clift Hotel",
            "phoneNumber": "(415) 775-4700",
            "description": "A 6-minute walk from Union Square and 4 minutes from a Muni Metro station, this luxury hotel designed by Philippe Starck features an artsy furniture collection in the lobby, including work by Salvador Dali.",
            "address": {
                "streetNumber": "495",
                "streetName": "Geary St",
                "city": "San Francisco",
                "state": "CA",
                "country": "United States",
                "postalCode": "94102"
            }
        }
    ],
    "ratePlans": [
        {
            "hotelId": 1,
            "code": "RACK",
            "inDate": "2015-04-09",
            "outDate": "2015-04-10",
            "roomType": {
                "bookableRate": 109,
                "totalRate": 109,
                "TotalRateInclusive": 123.17,
                "code": "KNG"
            }
        }
    ]
}

Credits

This example codebase was heavily inspired by the following talks/repositories:

About

HTTP up front, Protobufs in the rear.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 83.7%
  • Protocol Buffer 14.2%
  • Makefile 1.2%
  • Shell 0.9%