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"}'