Azure Container Apps での Eureka Server for Spring コンポーネント (プレビュー) の設定を構成する

Eureka Server for Spring は、マイクロサービス用に一元化されたサービス検出のメカニズムです。 Eureka Server for Spring コンポーネントを構成して管理する方法を確認するには、次のガイダンスを使用してください。

表示

show コマンドを使用して、名前ごとに個々のコンポーネントの詳細を表示できます。

次のコマンドを実行する前に、 <> で囲まれたプレースホルダーを実際の値に置き換えます。

az containerapp env java-component eureka-server-for-spring show \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME>

一覧取得

list コマンドを使用して、登録されているすべての Java コンポーネントを一覧表示できます。

次のコマンドを実行する前に、 <> で囲まれたプレースホルダーを実際の値に置き換えます。

az containerapp env java-component list \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP>

バインドの解除

コンテナー アプリからバインドを削除するには、--unbind オプションを使用します。

次のコマンドを実行する前に、 <> で囲まれたプレースホルダーを実際の値に置き換えます。

az containerapp update \
  --name <APP_NAME> \
  --unbind <JAVA_COMPONENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Eureka Server for Spring で許可される構成のリスト

次の一覧に、サポートされている構成の詳細を示します。 詳細については、Spring Cloud Eureka Server に関するトピックをご覧ください。

構成オプション

az containerapp update コマンドは、--configuration パラメータを使用して Eureka Server for Spring の構成方法を制御します。 スペースで区切ることで、一度に複数のパラメーターを使用することが可能です。 詳細については、Spring Cloud Eureka Server のドキュメントをご覧ください。

eureka.server 構成プロパティでは、次の構成設定を使用できます。

一般的な構成

• ログ関連の構成
  • logging.level.*
  • logging.group.*
  • logging.* 名前空間の下での他の構成は禁止する必要があります。たとえば、logging.file を使用したログ ファイルの書き込みは禁止する必要があります。

アプリケーション間の呼び出し

この例では、Eureka Server for Spring コンポーネントに登録されたアプリケーション間で呼び出すための Java コードの記述方法を示します。 コンテナー アプリが Eureka とバインドされると、Eureka サーバー経由で相互に通信します。

この例では、呼び出し元と呼び出し先の 2 つのアプリケーションを作成します。 両方のアプリケーションは、Eureka Server for Spring コンポーネントを使用して相互に通信します。 呼び出し先アプリケーションは、呼び出し元アプリケーションから呼び出しを受けるエンドポイントを公開します。

1. 呼び出し先アプリケーションを作成します。 メイン クラスに @EnableDiscoveryClient 注釈を追加して、Spring Boot アプリケーションで Eureka クライアントを有効にします。

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CalleeApplication {
   	public static void main(String[] args) {
   		SpringApplication.run(CalleeApplication.class, args);
   	}
   }
   

2. 呼び出し先アプリケーションは、呼び出し元アプリケーションから呼び出しを受けるエンドポイントを公開します。

   @RestController
   public class CalleeController {
   
       @GetMapping("/call")
       public String calledByCaller() {
           return "Hello from Application callee!";
       }
   }
   

3. アプリケーション構成ファイルに、呼び出し先アプリケーションの名前を設定します。 例: application.yml。

   spring.application.name=callee
   

4. 呼び出し元アプリケーションを作成します。

   @EnableDiscoveryClient 注釈を追加して、Eureka クライアント機能を有効にします。 また、他のサービスへの負荷分散呼び出しを実行するために、@LoadBalanced 注釈を持つ WebClient.Builder Bean を作成します。

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CallerApplication {
   	public static void main(String[] args) {
   		SpringApplication.run(CallerApplication.class, args);
   	}
   
   	@Bean
   	@LoadBalanced
   	public WebClient.Builder loadBalancedWebClientBuilder() {
   		return WebClient.builder();
   	}
   }
   

5. アプリケーション名 callee を使用して呼び出し先アプリケーションを呼び出すために WebClient.Builder を使用する呼び出し元アプリケーションでコントローラーを作成します。

   @RestController
   public class CallerController { 
       @Autowired
       private WebClient.Builder webClientBuilder;
   
       @GetMapping("/call-callee")
       public Mono<String> callCallee() {
           return webClientBuilder.build()
               .get()
               .uri("http://callee/call")
               .retrieve()
               .bodyToMono(String.class);
       }
   }
   

これで、Eureka Server for Spring Java コンポーネントを使用して相互に通信する呼び出し元アプリケーションと呼び出し先アプリケーションができました。 呼び出し元アプリケーションで /call-callee エンドポイントをテストする前に、両方のアプリケーションが実行され、Eureka サーバーとバインドされていることを確認してください。

制限事項

• Eureka Server Java コンポーネントには、false に設定された既定の構成 eureka.server.enable-self-preservation が付属します。 この既定の構成は、自己保存を有効にした後にインスタンスが削除されない時間を回避するのに役立ちます。 インスタンスの削除が早すぎると、存在しないインスタンスに要求が行われる場合があります。 この設定を true に変更する場合は、Java コンポーネントに独自の構成を設定することでオーバーライドできます。

• Eureka サーバーにはレプリカが 1 つしかなく、スケーリングはサポートされていないため、ピア Eureka サーバー機能を利用できません。

• Eureka ダッシュボードは利用できません。

次のステップ