プロジェクト依存関係の設定
まず、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);
}
}
動作検証と確認
両方のアプリケーションを実行した後、以下の手順で正常に連携しているか確認します。
- Eureka のサーバーインスタンスを起動し、8761 ポートでリスニングしていることを確認します。
- 次に、クライアント側のマイクロサービスを起動して、登録処理が行われていることを観察します。
- ブラウザから管理インターフェースを開きます。URL は
http://localhost:8761です。 - Eureka Dashboard ページには、現在登録されているサービス一覧が表示されます。