https://github.com/ghurtchu/lb

:computer: :arrows_counterclockwise: :computer: Application layer load balancer written in Scala & http4s & cats-effect featuring concurrency and efficiency.
https://github.com/ghurtchu/lb

cats-effect concurrency functional-programming http4s loadbalancer scala scala3

Last synced: 3 days ago
JSON representation

:computer: :arrows_counterclockwise: :computer: Application layer load balancer written in Scala & http4s & cats-effect featuring concurrency and efficiency.

• Host: GitHub
• URL: https://github.com/ghurtchu/lb
• Owner: Ghurtchu
• Created: 2023-08-26T17:32:55.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2023-09-08T22:08:15.000Z (about 1 year ago)
• Last Synced: 2024-01-26T09:34:55.702Z (10 months ago)
• Topics: cats-effect, concurrency, functional-programming, http4s, loadbalancer, scala, scala3
• Language: Scala
• Homepage:
• Size: 101 MB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Demo video tutorial for testing: https://www.youtube.com/watch?v=SkQ6s_nwCgY

Current implementation uses round robin algorithm for distributing requests.

Also, it periodically checks the availabilty of backends and stops forwarding requests to the unavailable servers.

As soon as dead server is back and up & running it starts forwarding requests to it.

Comprehensive testing instructions:

Configure load balancer in `src/main/resources/application.conf`:

![My Image](img/config.png)

Run a few backends on different ports:

- `./be 8081`

![My Image](img/8081.png)

- `./be 8082`

![My Image](img/8082.png)

- `./be 8083`

![My Image](img/8083.png)

Run the load balancer and observe health check logs:

- `./lb`

![My Image](img/lb-healthcheck-logs.png)

Ping the load balancer and observe responses from different servers:

- `curl localhost:8080`

![My Image](img/lb-curl.png)

Stop one of the backends (8081):

![My Image](img/stop-8081.png)

Observe the load balancer adjust distributing requests to only two servers:

![My Image](img/lb-adjusted-1.png)

Run the server with port 8081 again:

- `./be 8081`

![My Image](img/8081.png)

Observe the load balancer adjust distributing requests to all three servers again:

- `curl localhost:8080`

![My Image](img/final.png)