Architect’s Guide: A Complete Analysis of Service Registry and Discovery Tools

Service Discovery
Service Discovery
Table of Contents Hide
  1. 1. Introduce the concept of service registration and discovery
    1. 1.1 Challenges of Microservices and the Necessity of Service Discovery
    2. 1.2 Basic Concepts of Service Registration and Service Discovery
  2. 2. Zookeeper
    1. 2.1 Introduction and Features of Zookeeper
    2. 2.2 Implementing service registration in Zookeeper
    3. 2.3 How does the client discover services from Zookeeper?
  3. 3. Third-party registration and independent service registrar
    1. 3.1 The role and benefits of independent service registrar
    2. 3.2 Key Steps to Implementing an Independent Service Registrar
    3. 3.3 Third-party service and service registration interaction process
  4. 4. Server Discovery
    1. 4.1 Server-side Discovery Mechanism and Advantages
    2. 4.2 Strategies for Implementing Server Discovery
  5. 5. Client Discovery
    1. 5.1 Principles of Client Discovery
    2. 5.2 Patterns for Implementing Client Discovery
  6. 6. Use Consul for service registration and discovery
    1. 6.1 Introduction to Consul
    2. 6.2 Using Consul to implement service registration
    3. 6.3 Service Discovery and Health Check
  7. 7. Eureka’s service registration and discovery mechanism
    1. 7.1 Overview of Eureka Architecture
    2. 7.2 Implementing service registration and discovery in Eureka
    3. 7.3 Eureka client and server interaction details
  8. 8. SmartStack’s role in service registration and discovery
    1. 8.1 SmartStack Composition
    2. 8.2 How to use SmartStack for service registration and discovery
  9. 9. Etcd as a service discovery solution
    1. 9.1 Introduction and Features of Etcd
    2. 9.2 Implementing the process of service registration and discovery in Etcd
    3. 9.3 Comparison with other service discovery tools
  10. 10. Summary and best practices
    1. 10.1 Choose the appropriate service registration and discovery tool based on actual application
    2. 10.2 Analyze the role of service registration and discovery in system architecture based on case studies
  11. Author

1. Introduce the concept of service registration and discovery

1.1 Challenges of Microservices and the Necessity of Service Discovery

With the popularity of microservice architecture, an application may be decomposed into multiple service units, and each service may be deployed on different servers. Services need to communicate with each other, but the location of services may change frequently, which requires a mechanism to dynamically find the current location of the service, namely service discovery.

1.2 Basic Concepts of Service Registration and Service Discovery

Service registration means that when a service is started, its information (such as IP address, port, etc.) is registered in a public place so that other services can discover and call it. Service discovery means that service consumers retrieve detailed information about service providers from the registration center according to a certain mechanism and interact with them.
Client registration and Zookeeper

2. Zookeeper

2.1 Introduction and Features of Zookeeper

Apache Zookeeper is an open source service coordination tool that provides consistency services for distributed systems, such as configuration maintenance, domain name services, distributed synchronization, and group services.

2.2 Implementing service registration in Zookeeper

Service registration is very simple. When the service starts, the Zookeeper client will create a temporary child node under a specific node in Zookeeper. The node data contains the address information of the service.

// Pseudocode for registering a service using a Zookeeper client
public void registerService(String serviceName, String serviceAddress) {
    CuratorFramework client = ... // Initialize the Zookeeper client
    client.create().creatingParentsIfNeeded().withMode(CreateMode.EPHEMERAL_SEQUENTIAL)
        .forPath("/services/" + serviceName + "/service-", serviceAddress.getBytes());
}

2.3 How does the client discover services from Zookeeper?

Client discovery service is the process of retrieving service information from Zookeeper. The client can monitor the changes of Zookeeper nodes and update the local service information accordingly.

// Pseudocode for discovering a service using a Zookeeper client
public List<String> discoverService(String serviceName) {
    CuratorFramework client = ... // Initialize the Zookeeper client
    List<String> services = client.getChildren().forPath("/services/" + serviceName);
    return services.stream().map(data -> new String(client.getData().forPath("/services/" + serviceName + "/" + data)))
        .collect(Collectors.toList());
}

3. Third-party registration and independent service registrar

3.1 The role and benefits of independent service registrar

An independent service registrar is a separate service that is responsible for service registration and discovery. Unlike the client registration integrated in each microservice, it provides higher flexibility and scalability. An independent registration center can better manage service status and achieve load balancing, while reducing the number of components that each service needs to maintain.

3.2 Key Steps to Implementing an Independent Service Registrar

Building a service registrar usually involves the following key steps:

  • Create a service registry to store information about service instances.
  • Implements the service registration API, allowing services to register themselves when they start.
  • Implements the service deregistration API, allowing services to deregister themselves when shutting down.
  • Implements a service discovery API, allowing clients to query currently available service instances.
  • Implement a heartbeat mechanism so that the Service Registrar can detect and clean up unhealthy or no longer existing service instances.

3.3 Third-party service and service registration interaction process

Here is an example of how a service instance interacts with a standalone service Registrar:

// Pseudocode for discovering a service using a Zookeeper client
public class ServiceRegistrar {
public List<String> discoverService(String serviceName) {
    CuratorFramework client = ... // Initialize the Zookeeper client
    List<String> services = client.getChildren().forPath("/services/" + serviceName);
    return services.stream().map(data -> new String(client.getData().forPath("/services/" + serviceName + "/" + data)))
        .collect(Collectors.toList());
}
public class ServiceRegistrar {
    private Map<String, List<String>> serviceRegistry = new ConcurrentHashMap<>();
    public void register(String serviceName, String serviceInstance) {
        serviceRegistry.computeIfAbsent(serviceName, k -> new CopyOnWriteArrayList<>())
                       .add(serviceInstance);
    }
    public void unregister(String serviceName, String serviceInstance) {
        serviceRegistry.getOrDefault(serviceName, new CopyOnWriteArrayList<>())
                       .remove(serviceInstance);
    }
    public List<String> discover(String serviceName) {
        return serviceRegistry.getOrDefault(serviceName, Collections.emptyList());
    }
}

In the above code, we created a simple service Registrar, which maintains a service registry and provides register, unregister, and discover methods for service instances to call.

4. Server Discovery

4.1 Server-side Discovery Mechanism and Advantages

Server discovery means that the client obtains detailed information about available services by querying a centralized service discovery mechanism. This mechanism simplifies the client logic because the client does not need to monitor the status of the service, and these responsibilities are transferred to the server. This method is usually accompanied by the use of a load balancer, which can improve the reliability and resilience of the system to a certain extent.

4.2 Strategies for Implementing Server Discovery

Server discovery can be achieved in a variety of ways, but common strategies include:

  • Use a load balancer, such as Nginx or HAProxy, which periodically fetches the latest list of services from the service registry.
  • The service registry pushes updates to the load balancer so that it always has the latest service information.
  • The service registry itself includes load balancing capabilities.
// Simplified example configuration code for implementing server-side service discovery using Nginx as a load balancer

http {
    upstream myapp1 {
        server srv1.example.com;
        server srv2.example.com;
        server srv3.example.com;
    }
    server {
        listen 80;
        location / {
            proxy_pass http://myapp1;
        }
    }
}

In this example, we configure Nginx as a load balancer that proxies traffic to the service instances defined in the myapp1 upstream. The list of service instances can be updated dynamically through the service registry.

5. Client Discovery

5.1 Principles of Client Discovery

In client discovery mode, the client obtains the location information of other services by querying the service registry, and then communicates directly with the service provider. This approach allows the client to have more flexibility and it can adopt different load balancing strategies as needed.

5.2 Patterns for Implementing Client Discovery

To implement service discovery on the client side, you can take the following steps:
Pull a list of services from the service registry.
Select a service instance based on a specific load balancing strategy (such as polling, random selection, weight distribution, etc.).
Initiate a service call request.
Refresh the service list periodically or as needed.

// Pseudocode example for client-side service discovery
public class ServiceDiscoveryClient {
    private final ServiceRegistrar registrar;
    
    public ServiceDiscoveryClient(ServiceRegistrar registrar) {
        this.registrar = registrar;
    }
    
    public String discoverService(String serviceName) {
        List<String> instances = registrar.discover(serviceName);
        // Use a simple load balancing strategy to select a service instance
        return instances.isEmpty() ? null : instances.get(new Random().nextInt(instances.size()));
    }
    
    public void callService(String serviceName) {
        String serviceUrl = discoverService(serviceName);
        if (serviceUrl != null) {
            // Make a service call, for example, through an HTTP request
            System.out.println("Calling " + serviceName + " at " + serviceUrl);
        } else {
            System.err.println("Service " + serviceName + " not found!");
        }
    }
}

In this example, the ServiceDiscoveryClient class contains the service discovery logic and uses a simple random selection strategy to select one of multiple service instances to perform the call.

6. Use Consul for service registration and discovery

6.1 Introduction to Consul

Consul is an open source tool launched by HashiCorp, which aims to provide service discovery and configuration in service mesh solutions. It adopts a distributed, highly available architecture with built-in service registration, service discovery, health check, Key/Value storage and other functions.

6.2 Using Consul to implement service registration

Registering a service in Consul typically involves adding the service’s information to Consul’s service catalog at startup. Consul provides an HTTP API and client libraries in various languages ​​to achieve this.
The following is a simplified code example of using a Java client to register a service with Consul:

// Example of service registration using a Consul client
public class ConsulRegistration {
    public static void registerService(ConsulClient client, String serviceName, String serviceId, String serviceAddress, int servicePort) {
        NewService newService = new NewService();
        newService.setId(serviceId);
        newService.setName(serviceName);
        newService.setAddress(serviceAddress);
        newService.setPort(servicePort);
        NewService.Check serviceCheck = new NewService.Check();
        serviceCheck.setHttp("http://" + serviceAddress + ":" + servicePort + "/health");
        serviceCheck.setInterval("10s");
        newService.setCheck(serviceCheck);
        client.agentServiceRegister(newService);
    }
}

6.3 Service Discovery and Health Check

While discovering services, Consul also provides a health check function to help discover and avoid sending requests to unhealthy service instances. Service consumers can use the Consul API to query service information and get a list of only healthy service instances.

// Example of service discovery using a Consul client
public class ConsulDiscovery {
    public static List<ServiceHealth> discoverHealthyServices(ConsulClient client, String serviceName) {
        Response<List<ServiceHealth>> healthServices = 
            client.getHealthServices(serviceName, true, QueryParams.DEFAULT);
        return healthServices.getValue();
    }
}

In the above code, the discoverHealthyServices method returns all healthy service instances. It ensures that the client does not try to call any service that is in a failed state.

7. Eureka’s service registration and discovery mechanism

7.1 Overview of Eureka Architecture

Eureka is a service discovery framework developed by Netflix and is one of the important components in the Spring Cloud system. Eureka is a REST-based service used to locate middle-tier services running in the AWS domain. Its design philosophy is “registration center is also a service”, which can provide high-availability service registration and discovery functions.

7.2 Implementing service registration and discovery in Eureka

The service uses the Eureka client to self-register with the Eureka server at startup and maintains its registration information through heartbeats periodically (30 seconds by default), thereby achieving self-registration and self-update of the service.

// Code snippet for registering a service using Eureka Client
@EnableEurekaClient
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

In this code, the @EnableEurekaClient annotation indicates that the application is a Eureka client, which automatically registers itself with the Eureka Server.

7.3 Eureka client and server interaction details

The interaction between the Eureka client and the server includes service registration, service renewal, and obtaining service registration information. The Eureka server stores the service information and updates its status when receiving the client’s service renewal request. If the heartbeat is not received within the scheduled time, the server will remove the instance.

// Example of service discovery using Eureka Client
@Autowire
private DiscoveryClient discoveryClient;
public List<ServiceInstance> serviceUrlForDiscoveryClient(String serviceName) {
    return discoveryClient.getInstances(serviceName);
}

In this example, DiscoveryClient is used to query all available instances of serviceName. Spring Cloud’s abstract DiscoveryClient can be easily integrated with Eureka.

8. SmartStack’s role in service registration and discovery

8.1 SmartStack Composition

SmartStack is an automatic service discovery and registration framework developed by Airbnb. It consists of two core components:
Nerve: responsible for service health checks and registration, reporting service registration information to the service discovery system.
Synapse: responsible for service discovery, acting as a local proxy to communicate and obtain the latest list of service instances.

8.2 How to use SmartStack for service registration and discovery

The workflow of SmartStack is that Nerve will execute the health check script locally when starting the service. If the service is healthy, it will register the service information to Zookeeper. Synapse is responsible for regularly checking the service information registered on Zookeeper, updating the local HAProxy configuration, and performing service proxying.

# Nerve Configuration Example:
services:
  "service_name":
    host: "localhost"
    port: 3000
    checks:
      - type: "http"
        uri: "/health"
        timeout: 0.2
        rise: 3
        fall: 2
    report:
      zk_hosts: ["zkserver:2181"]
      zk_path: "/nerve/services/service_name"
      zk_data: '{"host": "localhost", "port": 3000}'

In the above configuration, Nerve will send a health check request to localhost:3000/health and write the service information to Zookeeper upon success.

# Synapse Configuration Example:
services:
  "service_name":
    discovery:
      method: "zookeeper"
      path: "/nerve/services/service_name"
      hosts: ["zkserver:2181"]
    haproxy:
      port: "3210"
      server_options: "check inter 2000 rise 3 fall 2"
      frontend: |
        timeout client  1m
      backend: |
        timeout server  1m

In this configuration, Synapse will query the services registered in Zookeeper and add them as backend services in the HAProxy configuration.

9. Etcd as a service discovery solution

9.1 Introduction and Features of Etcd

Etcd is a highly available key-value storage system, mainly used for shared configuration and service discovery. It was written by the CoreOS team and uses the Raft algorithm to provide consistency guarantees. Etcd is suitable for storing critical data, such as database connection information or service addresses, for use in distributed systems.

9.2 Implementing the process of service registration and discovery in Etcd

Etcd’s operations are mainly carried out through HTTP API. Service registration is to store the key-value pairs of service locations in Etcd, and service discovery is to find these key-value pairs.

// Pseudocode example for registering a service using Etcd
public void registerServiceWithEtcd(String serviceName, String serviceAddress, int servicePort) {
String key = "/services/" + serviceName;
String value = serviceAddress + ":" + servicePort;
EtcdClient etcd = new EtcdClient(URI.create("http://etcdserver:4001"));
etcd.put(key, value).ttl(60).send().get(); // Set a TTL of 60 seconds
}

9.3 Comparison with other service discovery tools

Compared with other service registration and discovery tools, Etcd provides a simpler API and is very sensitive to dynamic configuration changes. It is often used in container orchestration tools such as Kubernetes. Its distributed design means that read and write operations are very fast, but its implementation is simpler than Eureka and Consul, and it does not have built-in advanced features such as service health checks.

10. Summary and best practices

10.1 Choose the appropriate service registration and discovery tool based on actual application

When choosing a service registration and discovery tool, you need to consider the specific needs of the system. For example, if you are using a microservice architecture and need a solution that supports service health checks, Consul or Eureka may be a better choice. If you need a simple and efficient key-value store to quickly implement service discovery, Etcd can be an ideal candidate.

10.2 Analyze the role of service registration and discovery in system architecture based on case studies

In modern software architecture, service registration and discovery is a fundamental component of microservice architecture, which is related to the overall performance and reliability of the system. A good practice is to combine actual system cases, deeply understand the advantages and disadvantages of various service discovery tools, and make choices suitable for your own projects on this basis. As part of the best practices, the following are some general suggestions:

Consider using a service mesh to further decouple service-to-service communication and service discovery implementations.

In production environments, choose mature tools with active community support.

Ensure the high availability of the registration center to avoid it becoming a single point of failure in the system.

Combined with service health checks, ensure that traffic is only routed to healthy service instances.

Author

  • Mohamed BEN HASSINE

    Mohamed BEN HASSINE is a Hands-On Cloud Solution Architect based out of France. he has been working on Java, Web , API and Cloud technologies for over 12 years and still going strong for learning new things. Actually , he plays the role of Cloud / Application Architect in Paris ,while he is designing cloud native solutions and APIs ( REST , gRPC). using cutting edge technologies ( GCP / Kubernetes / APIGEE / Java / Python )

    View all posts
0 Shares:
You May Also Like