Skip to content

bretmckee/microservice

Repository files navigation

Microservice Example

This repo contains an example gRPC based microservice.

The example contains two services, named frontend and backend. They both have gRPC APIS defined in apis/<service>/proto, and the both export REST api endpoints as well, which we use for testing.

Docker is required to build the software. Once Docker is installed on your development machine, it is necessary to build the base container image that is used to build the software:

./build-base.sh

The software can be built locall (useful for browing the generated code) using:

./docker-run.sh commands

or it can be built as contianers (useful for testing with the instructions which follow):

./docker-run.sh make containers

To launch and test the backend use:

 docker run -it --rm --name backend -p 8101:443 backend --certfile=testdata/selfsigned.crt --keyfile=testdata/selfsigned.key --insecure
 # Test the back end using curl
 curl -v -X POST --insecure -w "\n" https://localhost:8101/v1/microserver/backend/process -d '{"input":"foo"}'

To launch and test the frontend, which requires the backend to be running, use:

 docker run -it --rm --name backend -p 8101:443 -v ${PWD}/testdata:/testdata backend --certfile=/testdata/selfsigned.crt --keyfile=/testdata/selfsigned.key --insecure

 # When the backend container starts, it will list the IP address of its adapter. You
 # need to use it here.

 docker run -it --rm --name frontend -p 8100:443 -v ${PWD}/testdata:/testdata frontend --backend "<backend_ip>:443" --certfile=/testdata/selfsigned.crt --keyfile=/testdata/selfsigned.key --insecure 
 # Test the front end using curl
 curl -v -X POST -w "\n" --insecure https://localhost:8100/v1/microserver/process -d '{"input":"foo"}'

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published