tiny-loadbalancer

TinyLoadbalancer is an HTTP load balancer that supports several strategies for distributing incoming requests across a pool of backend servers. It uses a configuration file to define its behavior and the servers to which it should forward requests.

Features

• Supports multiple load balancing strategies:
  • Round Robin
  • Weighted Round Robin
  • Random
  • IP hashing
  • Least connections
  • Least response time
• Health checks for backend servers.
• Retry requests on failure.
• Customizable configuration via config.json.

Configuration

TinyLoadbalancer expects a path to a config.json file that defines its configuration. (See config.json for an example configuration.)

{
  "port": 3333,
  "strategy": "weighted-round-robin",
  "healthCheckInterval": "30s",
  "retryRequests": true,
  "servers": [
    {
      "url": "http://localhost:8081",
      "weight": 5
    },
    {
      "url": "http://localhost:8082",
      "weight": 3
    },
    {
      "url": "http://localhost:8083",
      "weight": 2
    }
  ]
}

Configuration Fields

• port: The port where the load balancer listens for incoming requests.

• strategy: The load balancing strategy to use . Possible values are:

  • "round-robin"
  • "random"
  • "weighted-round-robin"
  • "ip-hashing"
  • "least-connections"
  • "least-response-time"

  See all here

• healthCheckInterval: The interval between health checks, specified as a duration string (e.g., 30s).

• retryRequests: A boolean indicating whether to retry requests on another server if the initial request fails.

• servers: An array of server objects. Each object must contain:

  • url: The URL of the backend server.
  • weight: The weight of the server for weighted load balancing strategies.

Run locally

• You can start your own servers or dummy servers with go run e2e_tests/server/server.go 8081. Pass different ports to start multiple servers.
• Run the load balancer with go run main.go config.json.
• curl http://localhost:3333 to see the load balancer in action.

Testing

• make test