{"id":32977879,"url":"https://github.com/theiterators/reactive-microservices","last_synced_at":"2026-03-02T03:12:23.151Z","repository":{"id":30128259,"uuid":"33678254","full_name":"theiterators/reactive-microservices","owner":"theiterators","description":"Project showcasing different microservice communication styles using Scala, Akka, Play and other tools from Scala ecosystem","archived":false,"fork":false,"pushed_at":"2021-01-29T16:58:50.000Z","size":422,"stargazers_count":243,"open_issues_count":3,"forks_count":62,"subscribers_count":44,"default_branch":"master","last_synced_at":"2024-04-07T20:35:54.892Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theiterators.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-09T15:54:02.000Z","updated_at":"2024-03-25T21:03:48.000Z","dependencies_parsed_at":"2022-07-28T01:07:06.513Z","dependency_job_id":null,"html_url":"https://github.com/theiterators/reactive-microservices","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/theiterators/reactive-microservices","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theiterators%2Freactive-microservices","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theiterators%2Freactive-microservices/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theiterators%2Freactive-microservices/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theiterators%2Freactive-microservices/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theiterators","download_url":"https://codeload.github.com/theiterators/reactive-microservices/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theiterators%2Freactive-microservices/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29991321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-13T06:00:36.060Z","updated_at":"2026-03-02T03:12:23.146Z","avatar_url":"https://github.com/theiterators.png","language":"Scala","funding_links":[],"categories":["Theory"],"sub_categories":["Tutorials"],"readme":"# Reactive microservices\n\n[![Join the chat at https://gitter.im/theiterators/reactive-microservices](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/theiterators/reactive-microservices?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nReactive microservices is an Typesafe Activator Template completely devoted to microservices architecture. It lets you learn about microservices in general - different patterns, communication protocols and 'tastes' of microservices. All these concepts are demonstrated using Scala, Akka, Play and other tools from Scala ecosystem. For the sake of clarity, we skipped topics related to deployment and operations.\n\n## Prerequisites\n\nTo feel comfortable while playing with this template, make sure you know basics of Akka HTTP which is a cornerstone of this project. We recently released an [Akka HTTP activator template](https://typesafe.com/activator/template/akka-http-microservice) that may help you start. At least brief knowledge of [Akka remoting](https://typesafe.com/activator/template/akka-sample-remote-scala), [Akka persistence](https://typesafe.com/activator/template/akka-sample-persistence-scala), [Akka streams](https://typesafe.com/activator/template/akka-stream-scala) and [Play Framework websockets](https://typesafe.com/activator/template/anonymous-chat) is also highly recommended.\n\n## Structure\n\nThis activator template consists of 9 runnable subprojects — the microservices:\n * auth ones:\n   * `auth-codecard`\n   * `auth-fb`\n   * `auth-password`\n   * `identity-manager`\n   * `session-manager`\n   * `token-manager`\n * business logic ones:\n   * `btc-users`\n   * `btc-ws`\n * miscellaneous ones:\n   * `metrics-collector`\n   \nThey uses different communication methods, different databases, and different frameworks.\n\n## Setup\n\n#### Review the configuration files\n\nTake some time to review `application.conf` files that are located in ```resource``` subdirectory of each microservice. You can also look at `docker-compose.yml` file, which contains docker preconfigurated images for all the required databases.\n\n#### Run migrations (You don't need to do this step if you want to use our docker container)\n\nFor `auth-codecard`, `identity-manager` and `auth-password` you need to run the SQL migration scripts which are located in `postgres` directory. If you want to use non-default names please tweak the `application.conf` files.\nYou can also tweak and use this script in your console.\n\n```\ncd /where/this/activator/template/is/located/\npsql -h localhost -U postgres -f ./postgres/init.sql \u0026\u0026\npsql -h localhost -U postgres -f ./postgres/auth_entry.sql \u0026\u0026\npsql -h localhost -U postgres -f ./postgres/identity.sql\n```\n\n## Running\n\nRun `docker-compose up` in project main directory to launch databases, or if you are using your own database instances, make sure you have PostgreSQL, MongoDB and Redis up and running.\n\n#### akka-http\nYou can run each service separately, but we also we provided a SBT task called `runAll`.\n\n#### Play\nDue to some issues with Play/sbt cooperation `metrics-collector` and `btc-ws` should be run separately.\nIn order to run them in one sbt CLI instance use these commands:\n```\n; project btc-ws; run 9000\n```\n```\n; project metrics-collector; run 5001\n```\n\nEverything else should work out of the box. Enjoy!\n\n## Author \u0026 license\n\nIf you have any questions regarding this project contact: \n\nŁukasz Sowa \u003clukasz@iteratorshq.com\u003e from [Iterators](https://www.iteratorshq.com).\n\nFor licensing info see LICENSE file in project's root directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheiterators%2Freactive-microservices","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheiterators%2Freactive-microservices","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheiterators%2Freactive-microservices/lists"}