Service Discovery với Eureka: Xây Dựng Stack Netflix OSS Của Riêng Bạn | Java Spring Roadmap

Bài cũ hứa dạy bạn dựng “Netflix OSS stack” gồm Eureka, Ribbon, Hystrix và Zuul. Năm 2026 bộ đó không tồn tại như một gói: Hystrix rời Spring Cloud từ 2020, Ribbon được thay bằng Spring Cloud LoadBalancer, Sleuth đã archive. Trong spring-cloud-netflix 5.0.3 chỉ còn Eureka — vẫn được maintain, vẫn chạy tốt, nhưng là một lựa chọn chứ không phải mặc định.

Cập nhật 2026

  • Stack hiện tại: Boot 4.1.2, Framework 7.0.10, Spring Cloud 2025.1.4 (“Oakwood”), Java 25 LTS. Spring Cloud Netflix trong train là 5.0.3, kéo eureka-client/eureka-core 2.0.6.
  • Eureka không chết: Netflix phát hành 2.0.6 ngày 23-03-2026, dòng 1.10 vẫn có bản build mới. Mô tả “maintenance mode” của bài cũ đã lỗi thời.
  • Không còn “Netflix OSS” như một bộ: BOM Netflix 5.0.3 chỉ còn module Eureka; circuit breaker ở Resilience4j, tracing ở Micrometer Tracing.
  • Eureka không phải mặc định: trên Kubernetes, Service và DNS đã làm discovery; Eureka đáng dựng khi bạn có fleet VM/bare metal hoặc cần client-side load balancing theo zone.

Service discovery giải quyết bài toán gì

Trong monolith, gọi module khác là gọi method. Khi tách ra service, bạn gọi qua mạng và địa chỉ không còn cố định: pod restart đổi IP, autoscaling thêm instance, deploy đổi port. Hard-code IP vào config nghĩa là mỗi lần scale bạn phải sửa và deploy lại hàng loạt service.

Discovery biến địa chỉ vật lý thành tên logic. Service tự mô tả mình là catalog-service; caller chỉ cần biết tên đó. Registry giữ danh sách instance đang đăng ký, trạng thái sống/chết, và metadata như zone, version, weight. Chọn instance nào là việc của load balancer.

Client-side discovery: caller hỏi registry, cache danh sách rồi tự chọn instance — Eureka cộng Spring Cloud LoadBalancer đi theo hướng này. Server-side discovery: caller gọi một địa chỉ ổn định, thành phần trung gian (Kubernetes Service, ELB, API Gateway) tra registry và chuyển tiếp. Discovery không phải health check: instance heartbeat đều vẫn có thể đã cạn connection pool, nên luôn đi kèm timeout, retry giới hạn và circuit breaker.

Eureka hoạt động thế nào

Eureka Server là registry trong bộ nhớ, không có database phía sau; dữ liệu được tái tạo từ heartbeat sau restart. Client vừa đăng ký chính nó, vừa đọc registry của service khác. Khi khởi động, client gửi POST đăng ký kèm host, port, health URL, metadata; sau đó gửi PUT heartbeat mỗi 30 giây.

Server coi instance sống chừng nào lease còn hạn. Lease mặc định 90 giây; tác vụ eviction quét mỗi 60 giây và xóa lease hết hạn, nên instance chết biến mất khỏi registry trong khoảng 90–150 giây. Caller đọc qua cache 30 giây ở client, cộng cache phía server, nên độ trễ thực tế tính bằng phút.

Cơ chế Mặc định Hệ quả
Lease renewal 30 giây Tần suất heartbeat; tăng thì phát hiện chết chậm hơn
Lease expiration 90 giây Lỡ ba heartbeat liên tiếp thì hết hạn
Eviction scan 60 giây Tổng độ trễ xóa instance 90–150 giây
Registry fetch 30 giây Độ cũ của danh sách phía caller
Renewal threshold 0,85 trong 15 phút Ngưỡng bật self-preservation

Self-preservation bảo vệ registry khi mạng giữa client và server có vấn đề. Server so heartbeat nhận được với số kỳ vọng trong 15 phút; tỷ lệ xuống dưới 85% thì nó ngừng evict. Đổi lại, instance đã chết vẫn nằm trong registry cho tới khi tỷ lệ hồi phục.

Mỗi Eureka Server mặc định cũng là client và đăng ký với các peer; đăng ký ở peer A được replicate sang B, C. Replication bất đồng bộ và Eureka chọn availability thay vì consistency, nên các peer có thể lệch nhau. Đây là “split-brain” của Eureka: không có quorum, không có bản đúng duy nhất, chỉ hội tụ lại khi mạng ổn định.

Zone gắn qua eureka.instance.metadata-map.zone; Spring Cloud LoadBalancer đọc key zone trong metadata để ưu tiên instance cùng zone. Không có instance cùng zone, nó quay về toàn bộ danh sách — đúng thiết kế nhưng dễ khiến bạn tưởng zone preference hỏng.

Dựng Eureka Server

Dùng spring-cloud-starter-netflix-eureka-server với BOM spring-cloud-dependencies 2025.1.4; starter không cần version riêng. Project cần Java 17 trở lên, ở đây là Java 25.

// File: src/main/java/com/example/registry/RegistryApplication.java
package com.example.registry;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

@SpringBootApplication
@EnableEurekaServer
public class RegistryApplication {

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

@EnableEurekaServer nằm trong package org.springframework.cloud.netflix.eureka.server. Thiếu nó, starter vẫn ở trên classpath nhưng ứng dụng chạy như web app bình thường, không có endpoint /eureka.

# File: src/main/resources/application.yml
server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

Cấu hình này chạy standalone: server không tự đăng ký và không kéo registry từ peer. hostname là thứ server công bố cho client, không phải tên máy nó nhìn thấy — localhost khi chạy máy cá nhân, DNS nội bộ khi lên môi trường thật. Dashboard ở http://localhost:8761/; dữ liệu JSON ở /eureka/apps.

Cấu hình client

Client cần spring-cloud-starter-netflix-eureka-client, spring-boot-starter-webmvc nếu service có HTTP (-web đã deprecated ở Boot 4.1), và Actuator nếu cần health check thật.

# File: src/main/resources/application.yml (catalog-service)
spring:
  application:
    name: catalog-service

server:
  port: 8081

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/
    healthcheck:
      enabled: true
  instance:
    instance-id: ${spring.application.name}:${random.value}
    prefer-ip-address: true
    metadata-map:
      zone: zone-a

spring.application.name là service id trong registry; đặt theo nghiệp vụ, không theo hostname. instance-id mặc định là host:service:port; chạy nhiều instance trên cùng host thì thêm ${random.value} để chúng không ghi đè nhau. prefer-ip-address: true hợp cho container và máy nhiều NIC, nơi hostname không phân giải được từ phía caller.

healthcheck.enabled: true đẩy trạng thái Actuator lên Eureka. Không bật, Eureka chỉ biết heartbeat và luôn báo UP dù ứng dụng đang lỗi. Thuộc tính này phải nằm trong application.yml, không phải bootstrap.yml; đặt sai chỗ, instance đăng ký với trạng thái UNKNOWN.

@EnableDiscoveryClient vẫn tồn tại nhưng không cần: starter tự cấu hình. @EnableEurekaClient đã bị bỏ trong 5.0.3 — nếu IDE báo không tìm thấy symbol khi copy code cũ, đây là lý do.

Gọi service theo tên

Cách minh bạch nhất là inject DiscoveryClient. Đoạn dưới lấy instance đầu tiên; production nên chọn theo zone hoặc để LoadBalancer lo.

// File: src/main/java/com/example/order/CatalogLookup.java
package com.example.order;

import java.util.List;

import org.springframework.cloud.client.ServiceInstance;
import org.springframework.cloud.client.discovery.DiscoveryClient;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestClient;

@Component
public class CatalogLookup {

    private final DiscoveryClient discoveryClient;
    private final RestClient restClient;

    public CatalogLookup(DiscoveryClient discoveryClient, RestClient.Builder builder) {
        this.discoveryClient = discoveryClient;
        this.restClient = builder.build();
    }

    public String firstItem() {
        List<ServiceInstance> instances = discoveryClient.getInstances("catalog-service");
        if (instances.isEmpty()) {
            throw new IllegalStateException("catalog-service chưa đăng ký");
        }
        ServiceInstance instance = instances.get(0);
        return restClient.get()
                .uri(instance.getUri() + "/api/items/first")
                .retrieve()
                .body(String.class);
    }
}

ServiceInstance.getUri() trả về scheme, host, port đã đăng ký. Danh sách lấy từ cache cục bộ, không phải request tới server mỗi lần gọi — đúng thiết kế, nhưng cũng là lý do nó có thể cũ.

Với caller blocking, một RestClient.Builder có @LoadBalanced sẽ đi qua LoadBalancer (cần spring-cloud-starter-loadbalancer trên classpath). Thiếu annotation này, http://catalog-service bị hiểu là hostname thật và bạn nhận lỗi DNS.

// File: src/main/java/com/example/order/ClientConfig.java
package com.example.order;

import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestClient;

@Configuration
class ClientConfig {

    @Bean
    @LoadBalanced
    RestClient.Builder loadBalancedRestClientBuilder() {
        return RestClient.builder();
    }
}

URL dùng service id làm host: http://catalog-service/api/items. Cùng cơ chế áp dụng cho WebClient.Builder; với Gateway là prefix lb://catalog-service. RestTemplate đã deprecated ở Framework 7; codebase còn dùng vẫn chạy, nhưng RestClient là đường tiếp tục.

HA, zone và peer awareness

Một Eureka Server là single point of failure cho toàn bộ discovery. Tối thiểu ba peer, mỗi peer trỏ tới hai peer còn lại:

# Trên peer1; peer2 và peer3 trỏ về hai peer còn lại
eureka:
  client:
    service-url:
      defaultZone: https://peer2/eureka/,https://peer3/eureka/

Các peer giữ register-with-eureka và fetch-registry mặc định true; standalone mới tắt. Mất một peer thì registry vẫn phục vụ, nhưng sau partition client ở hai bên có thể thấy hai danh sách khác nhau.

Zone affinity chỉ tác dụng khi caller bật spring.cloud.loadbalancer.configurations=zone-preference và instance thật sự có metadata zone. Chỉ khai báo zone mà không bật supplier thì LoadBalancer vẫn round-robin xuyên zone.

Bảo mật Eureka Server

Dashboard và API đăng ký lộ tên service, IP, port, metadata — bản đồ hạ tầng của bạn. Đừng mở nó ra Internet. Tối thiểu dùng private network, HTTPS và Basic auth.

// File: src/main/java/com/example/registry/SecurityConfig.java
package com.example.registry;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.web.SecurityFilterChain;

import static org.springframework.security.config.Customizer.withDefaults;

@Configuration
class SecurityConfig {

    @Bean
    SecurityFilterChain eurekaSecurity(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(auth -> auth.anyRequest().authenticated())
                .httpBasic(withDefaults())
                .csrf(csrf -> csrf.ignoringRequestMatchers("/eureka/**"));
        return http.build();
    }
}

CSRF phải được miễn cho /eureka/**: Eureka client không gửi token, request đăng ký sẽ bị 403 nếu bỏ qua bước này. Khai báo user/password cố định qua spring.security.user.* hoặc một UserDetailsService, nếu không Boot tạo mật khẩu ngẫu nhiên mỗi lần khởi động. Phía client, nhúng credential vào URL là cách tài liệu Spring Cloud mô tả: https://user:pass@registry.internal/eureka/. Eureka chỉ dùng credential đầu tiên nó tìm thấy, nên đừng trông đợi mỗi peer một tài khoản.

Cần mutual TLS thì client có eureka.client.tls.*. Với hệ thống nội bộ, HTTPS một chiều cộng Basic auth là đủ; registry không được public và credential không nằm trong repo.

Khi nào dùng giải pháp nào

Giải pháp Phù hợp khi Điểm phải trả
Eureka Fleet VM/bare metal, nhiều service Spring, cần client-side LB theo zone Phải vận hành registry HA, bảo mật, self-preservation
Consul Estate đa runtime (Go, .NET, Java), cần health check mạnh và KV Thêm cluster và agent, vận hành nặng hơn
Kubernetes Service + DNS Toàn bộ workload nằm trong Kubernetes Không dùng ngoài cluster; ít metadata cho client-side LB
AWS Cloud Map Hạ tầng AWS, ECS hoặc Lambda, DNS namespace Khoá vào AWS; health phụ thuộc dịch vụ AWS đi kèm
DNS tĩnh Vài service ổn định, ít thay đổi TTL và cache, không health, scale thủ công

Eureka mạnh ở chỗ là Java process bạn tự vận hành, không phụ thuộc orchestrator; yếu ở chỗ bạn phải tự lo HA, bảo mật, quan sát.

Vì sao Eureka không bắt buộc

Ba service sau một API Gateway không cần registry: Gateway đã biết route, địa chỉ ít đổi. Discovery chỉ đáng giá khi số service và instance đủ lớn để cấu hình tay trở thành nguồn sai.

Trên Kubernetes, Service cộng CoreDNS đã phân giải tên; headless service cho phép lấy danh sách pod. Dựng thêm Eureka trong cluster là nhân đôi discovery, cộng bài toán IP pod đổi và self-preservation, không có lợi ích tương ứng.

Eureka đúng khi: fleet VM/bare metal không có orchestrator, nhiều service Spring Cloud, cần client-side load balancing và zone awareness, hoặc hệ thống đã chạy Eureka và chi phí thay thế lớn hơn chi phí giữ.

Pitfall thường gặp

  • Đăng ký nhưng không heartbeat. Thường do eureka.instance.hostname công bố địa chỉ caller không với tới, hoặc firewall chặn chiều ngược. Dashboard thấy instance nhưng request đều timeout; sửa bằng prefer-ip-address hoặc hostname phân giải hai chiều.
  • Instance cũ trong registry. Crash không deregister, cộng lease 90 giây, eviction 60 giây và cache 30 giây. Đừng coi registry là nguồn sự thật về health; đặt timeout ngắn và circuit breaker.
  • Sai defaultZone. Thiếu /eureka/, sai port, hoặc viết defaultzone chữ thường. defaultZone là key của một Map nên phân biệt hoa thường; service-url theo relaxed binding. Sai chỗ này, client khởi động bình thường nhưng không đăng ký ở đâu.
  • Self-preservation cascade. Deploy hoặc crash loop làm hàng loạt instance ngừng heartbeat, renewal xuống dưới 85%, server đóng băng instance đã chết. LoadBalancer vẫn gửi request tới chúng đúng lúc hệ thống xấu nhất. Giảm thiểu bằng graceful shutdown, giám sát tỷ lệ renewal, và nếu tắt self-preservation thì phải có phát hiện chết nhanh thay thế.
  • Health check sai file. eureka.client.healthcheck.enabled trong bootstrap.yml cho trạng thái UNKNOWN; đặt trong application.yml.
  • Zone không tác dụng. Khai báo metadata-map.zone nhưng không bật zone-preference. Kết quả là round-robin xuyên zone.
  • Dựng Eureka “vì microservices”. Không ai vận hành registry 24/7 thì bảng cấu hình tĩnh hoặc route ở Gateway rẻ và ổn định hơn.
  • Expose dashboard. Basic auth không cứu được registry mở ra Internet; đặt sau VPN hoặc private network và bật TLS.

Hướng 2027

Train Spring Cloud 2026.0 đang ở bản RC tại thời điểm viết, dựa trên Boot 4.2; Eureka nhiều khả năng vẫn nằm trong đó vì Netflix vẫn phát hành dòng 2.x. Hướng đầu tư của Spring vẫn nghiêng về HTTP Service Clients, LoadBalancer và discovery native của orchestrator. Đừng thiết kế mới quanh ý tưởng “cài cả bộ Netflix OSS”; chọn registry theo môi trường.

Checklist trước khi lên production

  • Eureka Server có ít nhất ba peer, mỗi peer trỏ tới hai peer còn lại, và đã thử mất một peer.
  • Registry nằm trong mạng nội bộ, có TLS và Basic auth; CSRF được miễn cho /eureka/**.
  • Client đặt spring.application.name ổn định, instance-id duy nhất, defaultZone đúng hoa thường.
  • healthcheck.enabled nằm trong application.yml; Actuator health trả lời trong vài giây.
  • Caller có timeout, retry giới hạn và circuit breaker; không retry POST không idempotent.
  • Có alert trên tỷ lệ renewal và số instance bị evict; biết trước sẽ làm gì khi self-preservation bật.

Đọc tiếp trong series