bmeviauav42 / todoapp-logging-hc

Mikroszolgáltatás alapú alkalmazás a naplózást és a health checket bemutató anyagrászekhez. Alapjául a https://github.com/bmeviauav42/todoapp szolgál

"To Do" alkalmazás mikroszolgáltatásokra építve

Naplózás és health check gyakorlat

A labor célja bemutatni a mikroszolgáltatásokra épülő rendszerek esetében gyakran használt polyglot elvet: mikroszolgáltatásonként más-más platformot és nyelvet, valamint más adatbázis rendszer használunk. A szolgáltatásokat pedig egy API gateway fogja össze.

Előkövetelmények

Az alkalmazás teljes egészében platformfüggetlen. A kényelmes fejlesztéshez azonban a forráskód Microsoft Visual Studio-t feltételez.

• Microsoft Visual Studio 2017/2019/2022
• Docker WSL2 támogatással
• Postman

Rendszer felépítése

A rendszer az alábbi mikroszolgáltatásokból épül fel:

• todos: A teendőket kezelő alkalmazás, ASP.NET Core platformon, REST API-t biztosítva. Elasticsearch adatbázist és Redis cache-t használ.
• web: React-ra épülő SPA webalkalmazás TypeScript-ben, NGINX webszerverrel kiszolgálva.
• users: Felhasználókat kezelő alkalmazás Python-ban, MongoDB adatbázisra épülve REST API-t biztosít.

                   +----+     +-------+      +---------+
                   |    +---->+ todos +--+-->+ elastic |
+-----------+      |API |     +-------+  |   +---------+
|  browser  +----->+gate|                |
+-----------+      |way |                |   +---------+
                   |    |     +-------+  +-->|  redis  |
                   |    +---->+  web  |      +---------+
                   |    |     +-------+
                   |    |
                   |    |     +-------+      +---------+
                   |    +---->+ users +----->+ mongodb |
                   +----+     +-------+      +---------+

Futtatás

Microsoft Visual Studio-ból

Az src/todoapp.sln solution fájlt megnyitva a docker-compose nevű projektet startup project-nek beállítva F5-tel indítható. A forráskódban történő bármely változtatás után (akár C# kód, akár más kód) ugyanígy fordítás és debug módú indítás szükséges.

Konzolból

Az src/docker könyvtárból az alábbi parancsokkal fordítható és indítható az alkalmazás:

docker-compose build
docker-compose up

URL-ek

Az egyes szolgáltatások az alábbi URL-eken érhetően el:

• Weboldal
  • http://localhost:5080
  • Visual Studio-ból futtatva közvetlenül http://localhost:5082
• Todos REST API
  • http://localhost:5080/api/todos
  • Visual Studio-ból futtatva közvetlenül http://localhost:5081/api/todos
• Users REST API
  • http://localhost:5080/api/users
  • Visual Studio-ból futtatva közvetlenül http://localhost:5083/api/users
• Traefik Dashboard: http://localhost:5088
• Mongodb: mongodb://localhost:27017
• Elasticsearch: http://localhost:9200

---

Az itt található oktatási segédanyagok a BMEVIAUAV42 tárgy hallgatóinak készültek. Az anyagok oly módú felhasználása, amely a tárgy oktatásához nem szorosan kapcsolódik, csak a szerző(k) és a forrás megjelölésével történhet.

Az anyagok a tárgy keretében oktatott kontextusban értelmezhetőek. Az anyagokért egyéb felhasználás esetén a szerző(k) felelősséget nem vállalnak.

todoapp-logging-hc's Issues

[Logging, Health Checks] kibana nem indul a laborgépeken

Kibanát nem lehet elérni az alapbeállításokkal, laboron.

Solution: Kicsit fel kell skálázni a vasat alatta. (pontos értékeket majd meg kell nézni)