• Introduction
• Running the Services
• Exploring the Service Graph
• Advanced Testing
• Stopping the Services
• How To Contribute

This project uses Docker and Docker Compose to build and run test services that can be used to demo the Health Checks API and Microservice Graph Explorer.

To build and run the test services, you must install the following:

Install Docker from https://docs.docker.com/install/.

Install Docker Compose from https://docs.docker.com/compose/install/.

Each service is written in Go and exposes the Health Checks API using the Go Health Checks Framework.

To build and run the services using Docker compose by running the follwing command:

docker-compose up -d --build

Once you have the services running locally in Docker, you can do a sanity check to make sure each service is running by loading the /status/about endpoint for demo app, service 1 and service 2.

Check the Microservice Graph Explorer app is running by loading https://localhost:9000 in your favorite browser. At this point you should see the homepage of the Microservice Graph Explorer with a link to Test Service Graph under Quick Links.

To start exploring, click on Test Service Graph and you'll see a page like: For more info, watch the demo video

If you want to simulate other failure types, like a warning or a cascading failure, you can do this by modifying the local.yml conf file for a service and then rebuild/deploy the services using Docker Compose.

To make the Mongo dependency of Service 1 fail, open docker/service-1/conf/local.yml and update the MONGO item under checks from result: "OK" to result: "CRIT" and enter an error message like details: "Can't connect" and then run:

docker-compose up -d --build

To make the Mongo dependency fail randomly, change the value randomlyfail: "false" to randomlyfail: "carview.php?tsp=true" and then build/deploy again using:

docker-compose up -d --build

To stop the services running on your machine, run:

docker-compose down --rmi all

Contribute by submitting a PR and a bug report in GitHub.

• Adam Arsenault - @Adam_Arsenault