Spring Cloud Eureka を用いたサービスディスカバリのセットアップ方法

プロジェクト依存関係の設定

まず、Spring Boot プロジェクトに Spring Cloud ネイティブスタックを読み込む必要があります。Maven を使用する場合は、以下のような依存関係を pom.xml ファイルに登録してください。

<dependencies>
    
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

    
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
</dependencies>

これらのモジュールを含めることで、サービスの登録および発見機能が有効になります。

構成ファイルの調整

各アプリケーションの状態(サーバーまたはクライアント)を切り替えるため、application.yml または application.properties で適切なパラメータを設定します。ここでは異なるポート番号とアプリ名を用いて、サーバー側とクライアント側の設定例を示します。

レジストリサーバー側の設定

自らの登録を行わないように設定することが重要です。

server:
  port: 8761

spring:
  application:
    name: discovery-service-center

eureka:
  client:
    register-with-eureka: false # 自分自身を登録しない
    fetch-registry: false      # 他のリストを取得しない

マイクログラフクライアント側の設定

中央サーバーへの接続先を指定し、自動登録を有効化します。

server:
  port: 9090

spring:
  application:
    name: backend-microservice

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

メインクラスの実装

Eureka サーバーとして動作するアプリケーションを作成します。名前空間アノテーションを使用して、サービス探索機能を提供するサーバーとしての振る舞いを定義します。

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

@SpringBootApplication
@EnableEurekaServer
public class ServiceRegistryStartup {

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

クライアントアプリケーションの実装

同様に、他のサービスを検索可能にするためのクライアント側も準備します。これにより、システム内のリソースが動的に見つかるようになります。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class ConsumerApplication {

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

動作検証と確認

両方のアプリケーションを実行した後、以下の手順で正常に連携しているか確認します。

  1. Eureka のサーバーインスタンスを起動し、8761 ポートでリスニングしていることを確認します。
  2. 次に、クライアント側のマイクロサービスを起動して、登録処理が行われていることを観察します。
  3. ブラウザから管理インターフェースを開きます。URL は http://localhost:8761 です。
  4. Eureka Dashboard ページには、現在登録されているサービス一覧が表示されます。

タグ: Spring-Cloud Eureka Microservices spring-boot

8月8日 10:20 投稿