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

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 매개 변수를 사용하여 Spring용 Eureka Server를 구성하는 방법을 제어합니다. 여러 매개 변수를 공백으로 구분하면 한 번에 여러 매개 변수를 사용할 수 있습니다. 자세한 내용은 Spring Cloud Eureka Server 문서에서 확인할 수 있습니다.

다음 구성 설정은 eureka.server 구성 속성에서 사용할 수 있습니다.

일반 구성

• 관련 구성 로깅
  • logging.level.*
  • logging.group.*
  • logging.* 네임스페이스 아래의 다른 모든 구성은 금지되어야 합니다. 예를 들어, logging.file을 사용하여 로그 파일을 작성하는 것은 금지되어야 합니다.

애플리케이션 간 호출

이 예에서는 Eureka Server for Spring 구성 요소에 등록된 애플리케이션 간 호출을 위한 Java 코드를 작성하는 방법을 보여 줍니다. 컨테이너 앱이 Eureka와 바인딩되면 Eureka 서버를 통해 서로 통신합니다.

이 예제에서는 호출자와 호출 수신자라는 두 개의 애플리케이션을 만듭니다. 두 애플리케이션 모두 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 빈을 만들어 다른 서비스에 대한 부하 분산 호출을 수행합니다.

   @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. 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 서버에는 복제본이 하나뿐이며 크기 조정을 지원하지 않으므로 피어 Eureka 서버 기능을 사용할 수 없습니다.

• Eureka 대시보드를 사용할 수 없습니다.

다음 단계