news feed microservice on play and scala
This is another implementation of the news feed microservice written in Scala on the Play Framework. This project started from the example project for Making a REST API in Play. I covered this microservice implementation in my blog on Writing Reactive Microservices for the JVM.
How to develop on this service. You need to download and install sbt for this application to run.
This command will run the unit tests.
Either running locally or load testing locally, you will need to set up port forwarding so that the service can access the back end data sources.
kubectl port-forward deployment/cassandra 9042:9042 & export NOSQL_HOST=127.0.0.1 kubectl port-forward deployment/mysql 3306:3306 & kubectl port-forward deployment/redis 6379:6379 & export CACHE_HOST=127.0.0.1 kubectl port-forward deployment/elasticsearch 9200:9200 & export SEARCH_HOST=127.0.0.1
The following at the command prompt will start up Play in development mode:
sbt "run 8080"
Play will start up on the HTTP port at http://localhost:8080/. You don't need to deploy or reload anything -- changing any source code while the server is running will automatically recompile and hot-reload the application on the next HTTP request.
The best way to see what Play can do is to run a load test. We've included Gatling in this test project for integrated load testing.
Start Play in production mode, by staging the application and running the play script.
sbt stage cd target/universal/stage ./bin/news-feed-play -Dplay.http.secret.key=LGG7q:ZHimG613xJXWL50cwgJ:nx6soU:XcPj2MhJ;GR[F0]ag:90cqpJ_
Then you'll start the Gatling load test up (it's already integrated into the project):
sbt ";project gatling;gatling:test"
Once the test completes, you'll see an HTML file containing the load test chart.
Build and Release
To be run in Kubernetes.
sbt dist cd target/universal unzip news-feed-play-1.0-SNAPSHOT.zip cd ../.. docker build -t feed12:1.0 .
Static Code Analysis
Average per file Lines of Code is 55.48 with a median of 51 and a standard deviation of 32.92. The news action builder scala file (mostly boilerplate) is the largest with 123 LoC but the unit tests file is a close second at 122 LoC. Total McCabe cyclomatic complexity is 1,764.
Load Test Results
Play can be configured to run with a choice of two server backend technologies, either akka http or netty. Here are the per minute outbound post performance results for both. Throughput is in requests per minute. The other columns measure average and percentile based latency in milliseconds.