Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elgris/microservice-app-example
Example of polyglot microservice app
https://github.com/elgris/microservice-app-example
Last synced: about 1 month ago
JSON representation
Example of polyglot microservice app
- Host: GitHub
- URL: https://github.com/elgris/microservice-app-example
- Owner: elgris
- License: mit
- Created: 2017-09-09T18:37:17.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T10:56:15.000Z (3 months ago)
- Last Synced: 2024-09-27T04:42:30.838Z (about 2 months ago)
- Language: JavaScript
- Size: 2.58 MB
- Stars: 1,389
- Watchers: 37
- Forks: 333
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
## Components
1. [Frontend](/frontend) part is a Javascript application, provides UI. Created with [VueJS](http://vuejs.org)
2. [Auth API](/auth-api) is written in Go and provides authorization functionality. Generates JWT tokens to be used with other APIs.
3. [TODOs API](/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](/log-message-processor).
4. [Users API](/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](/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](https://zipkin.io). Optional 3rd party system that aggregates traces produced by other components.
Take a look at the components diagram that describes them and their interactions.
## 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 http://127.0.0.1:8080 for web UI. [Zipkin](https://zipkin.io) is available on http://127.0.0.1:9411 by default.
## Contribution
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.
## License
MIT