Spring Boot 4 Microservices & REST APIs · Lesson

Client-Side Load Balancing with Ribbon

Integrate Ribbon for client-side load balancing across multiple service instances.

Client-Side Load Balancing with Ribbon is a free Spring Boot 4 Microservices & REST APIs lesson on CoddyKit — lesson 2 of 3. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Spring Boot 4 Microservices & REST APIs learning path, one of 3 lessons in the course, and your progress syncs across the web and the CoddyKit app.

What is Load Balancing?

In a microservices world, applications often have multiple copies (instances) of the same service running. This is for scalability and high availability.

Load balancing is the process of distributing incoming network traffic across these multiple instances. It ensures no single service instance gets overwhelmed.

Scalability: Handle more users by adding more instances.
High Availability: If one instance fails, others can take over.
Performance: Distribute work evenly to reduce response times.

Client-Side vs. Server-Side LB

There are two main types of load balancing:

Server-Side Load Balancing: A dedicated component (like Nginx or a hardware load balancer) sits in front of your services. Clients send requests to this component, and it forwards them to an appropriate service instance.
Client-Side Load Balancing: The client application itself is responsible for knowing about all available service instances and choosing one for each request. This is where tools like Ribbon come in!

Ribbon: Your Client-Side Helper

Ribbon is a client-side load balancer that integrates seamlessly with Spring Cloud applications. It helps your client service pick the right instance of a target service.

How does Ribbon know about service instances? It works hand-in-hand with a service discovery mechanism, like Eureka. Eureka tells Ribbon where services are, and Ribbon decides which one to call.

Adding Load Balancing Dependency

To enable client-side load balancing in your Spring Boot application, you typically include the Spring Cloud LoadBalancer dependency. While 'Ribbon' is in the lesson title, Spring Cloud LoadBalancer is its modern successor and works similarly.

Add this to your pom.xml:

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

Load Balanced RestTemplate

The easiest way to use client-side load balancing is with Spring's RestTemplate. By simply adding the @LoadBalanced annotation to your RestTemplate bean, Spring configures it to use a load balancer.

When you make an HTTP call, you'll use the logical service name (e.g., my-service) instead of a specific IP address and port. The load balancer (Ribbon/Spring Cloud LoadBalancer) resolves this name to a real instance.

Client Calling a Service (Code)

Here's a simple Spring Boot client application that uses a load-balanced RestTemplate to call another service named my-service. For this to work, my-service must be registered with a service discovery server (like Eureka).

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

@SpringBootApplication
@RestController
public class MyClientApplication {

    private final RestTemplate restTemplate;

    // Inject the load-balanced RestTemplate
    public MyClientApplication(@LoadBalanced RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public static void main(String[] args) {
        SpringApplication.run(MyClientApplication.class, args);
    }

    // Define the load-balanced RestTemplate bean
    @Bean
    @LoadBalanced 
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }

    // Endpoint to call 'my-service'
    @GetMapping("/call-my-service")
    public String callMyService() {
        // Use the logical service ID 'my-service'
        return restTemplate.getForObject("http://my-service/hello", String.class);
    }
}

Load Balancing Algorithms

Ribbon (and Spring Cloud LoadBalancer) can use different algorithms to decide which service instance to call. Some common ones include:

Round Robin: Distributes requests sequentially to each instance (e.g., instance 1, then 2, then 3, then 1 again).
Random: Picks a random instance for each request.
Availability Filtering: Ignores instances that are marked as down or unresponsive.
Weighted Response Time: Favors instances that have historically responded faster.

Configuring Load Balancing Rules

You can configure the load balancing rule for a specific service in your application.yml or application.properties. For example, to use a Round Robin rule for my-service (using older Ribbon config style):

my-service.ribbon.NFLoadBalancerRuleClassName=com.netflix.loadbalancer.RoundRobinRule

While this specific syntax is for older Ribbon, the concept of configuring rules per service is similar in Spring Cloud LoadBalancer, often done via custom configurations or properties.

Benefits of Client-Side LB

Client-side load balancing offers several advantages in a microservices architecture:

Simpler Infrastructure: No need for a separate hardware or software load balancer component.
Direct Communication: Clients communicate directly with service instances, potentially reducing latency.
Dynamic Scaling: Easily adapts to new service instances registering or deregistering with service discovery.
Granular Control: The client can implement custom load balancing logic or apply different rules per service.

Quick Check on Load Balancing

You've learned about client-side load balancing. Let's test your understanding.

Recap: Client-Side Load Balancing

Great job! You've explored client-side load balancing with Ribbon (and its successor, Spring Cloud LoadBalancer).

We learned that load balancing distributes traffic across service instances for scalability and availability.
Client-side load balancing means the client itself chooses which instance to call, often using a logical service name.
The @LoadBalanced annotation on a RestTemplate bean is key for enabling this feature in Spring Boot.
Various algorithms like Round Robin can be used to distribute requests.

This approach makes your microservices more robust and efficient!

Frequently asked questions

Is the “Client-Side Load Balancing with Ribbon” lesson free?

Yes — the full text of “Client-Side Load Balancing with Ribbon” is free to read here on the web, and the Spring Boot 4 Microservices & REST APIs course includes 3 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Spring Boot 4 Microservices & REST APIs course, upgrade to CoddyKit PRO.

What will I learn in “Client-Side Load Balancing with Ribbon”?

Integrate Ribbon for client-side load balancing across multiple service instances. You practise Spring Boot 4 Microservices & REST APIs with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Spring Boot 4 Microservices & REST APIs?

No prior experience is required. Spring Boot 4 Microservices & REST APIs on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 3, so you can start here or from the beginning and move at your own pace.

How long does the “Client-Side Load Balancing with Ribbon” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Spring Boot 4 Microservices & REST APIs lesson?

Yes. Every Spring Boot 4 Microservices & REST APIs lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Spring Boot 4 Microservices & REST APIs