February 22, 2019

348 words 2 mins read



Example of polyglot microservice app

repo name elgris/microservice-app-example
repo link https://github.com/elgris/microservice-app-example
language JavaScript
size (curr.) 2709 kB
stars (curr.) 1294
created 2017-09-09
license MIT License

Example microservice app

This is an example of web application comprising of several components communicating to each other. In other words, this is an example of microservice app. Why is it better than many other examples? Well, because these microservices are written in different languages. This approach gives you flexibility for running experiments in polyglot environment.

The app itself is a simple TODO app that additionally authenticates users. I planned to add some admin functionality, but decided to cut the scope and add it later if needed.


  1. Frontend part is a Javascript application, provides UI. Created with VueJS
  2. Auth API is written in Go and provides authorization functionality. Generates JWT tokens to be used with other APIs.
  3. TODOs API is written with NodeJS, provides CRUD functionality ove user’s todo records. Also, it logs “create” and “delete” operations to Redis queue, so they can be later processed by Log Message Processor.
  4. Users API is a Spring Boot project written in Java. Provides user profiles. Does not provide full CRUD for simplicity, just getting a single user and all users.
  5. Log Message Processor is a very short queue processor written in Python. It’s sole purpose is to read messages from Redis queue and print them to stdout
  6. Zipkin. Optional 3rd party system that aggregates traces produced by other components.

Take a look at the components diagram that describes them and their interactions. microservice-app-example

Use cases

  • Evaluate various instruments (monitoring, tracing, you name it): how easy they integrate, do they have any bugs with different languages, etc.

How to start

The easiest way is to use docker-compose:

docker-compose up --build

Then go to for web UI. Zipkin is available on by default.


This is definitely a contrived project, so it can be extended in any way you want. If you have a crazy idea (like RESTful API in Haskell that counts kittens of particular user) - just submit a PR.



comments powered by Disqus