자습서: Azure Container Apps에서 관리되는 Eureka Server for Spring에 연결

Eureka Server for Spring은 마이크로 서비스가 스스로 등록하고 다른 서비스를 검색할 수 있도록 하는 서비스 레지스트리입니다. 유레카 서버 for Spring은 Azure Container Apps 구성 요소로 사용할 수 있습니다. Eureka 서버에 자동 등록하기 위해 컨테이너 앱을 Spring용 Eureka Server에 바인딩할 수 있습니다.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 아직 없는 경우 무료로 만들 수 있습니다.
• Azure CLI

고려 사항

Container Apps에서 Spring용 Eureka Server를 실행하는 경우 다음 세부 정보를 알고 있어야 합니다.

설정

Spring용 Eureka Server 구성 요소 작업을 시작하기 전에 먼저 필요한 리소스를 만들어야 합니다.

Spring용 유레카 서버 Java 구성 요소 만들기

Spring Java 구성 요소용 유레카 서버에 컨테이너 앱 바인딩

포털에서 컨테이너 앱으로 돌아갑니다. 향후 단계에서 사용할 수 있도록 앱의 URL을 텍스트 편집기로 복사합니다.

경로로 이동하여 /allRegistrationStatus 유레카 서버 for Spring 구성 요소에 등록된 모든 애플리케이션을 봅니다.

바인딩은 주로 eureka.client.service-url.defaultZone 속성인 환경 변수로 여러 구성을 애플리케이션에 삽입합니다. 이 속성은 Eureka Server Java 구성 요소의 내부 엔드포인트를 나타냅니다.

바인딩은 다음 속성도 삽입합니다.

"eureka.client.register-with-eureka":    "true"
"eureka.client.fetch-registry":          "true"
"eureka.instance.prefer-ip-address":     "true"

eureka.client.register-with-eureka 속성은 Eureka Server에 등록을 적용하기 위해 true(으)로 설정됩니다. 이 등록은 구성 서버 등에서 application.properties로컬 설정을 덮어씁니다. false(으)로 설정하려면 컨테이너 앱에서 환경 변수를 설정하여 덮어쓸 수 있습니다.

eureka.instance.prefer-ip-address 컨테이너 앱 환경의 특정 도메인 이름 시스템 확인 규칙 때문에 속성이 설정 true 됩니다. 바인딩을 중단하지 않도록 이 값을 수정하지 마세요.

선택 사항: Spring Java용 Eureka Server 구성 요소에서 컨테이너 앱 바인딩 해제

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

대시보드를 통해 애플리케이션 보기

1. 사용자 지정 역할 정의를 만듭니다.

   az role definition create --role-definition '{
       "Name": "<YOUR_ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   값의 <SUBSCRIPTION_ID> 자리 표시자를 AssignableScopes 구독 ID로 바꿔야 합니다.

2. 관리되는 환경 리소스의 계정에 사용자 지정 역할을 할당합니다.

   다음과 같이 관리 환경의 리소스 ID를 가져옵니다.

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. 사용자의 계정에 역할을 할당합니다.

   이 명령을 실행하기 전에 대괄호로 <> 표시된 자리 표시자를 사용자 또는 서비스 주체 ID 및 역할 이름으로 바꿉니다.

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   참고 항목

   일반적으로 값은 <USER_OR_SERVICE_PRINCIPAL_ID> Azure Portal에 액세스하는 데 사용하는 ID여야 합니다. 값은 <ROLE_NAME> 1단계에서 할당한 이름입니다.

4. Spring용 유레카 서버 대시보드의 URL을 가져옵니다.

   az containerapp env java-component eureka-server-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   이 명령은 Spring용 Eureka Server 대시보드에 액세스하는 데 사용할 수 있는 URL을 반환합니다. 대시보드를 사용하면 다음 스크린샷과 같이 컨테이너 앱을 볼 수도 있습니다.

   

선택 사항: Spring용 유레카 서버와 Spring용 관리자 Java 구성 요소 통합

Spring용 유레카 서버와 Spring용 관리자 Java 구성 요소를 통합하려면 Spring용 관리형 관리자와 Spring용 유레카 서버 통합을 참조하세요.

리소스 정리

이 자습서에서 만든 리소스는 Azure 청구서에 영향을 줍니다. 이러한 서비스를 장기적으로 사용하지 않을 경우 다음 명령을 실행하여 이 자습서에서 만든 모든 항목을 제거합니다.

az group delete --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 구성 요소에서 고유한 구성을 설정하여 덮어쓸 수 있습니다.

다음 단계

관련 콘텐츠

Spring용 관리형 관리자와 Spring용 유레카 서버 통합