Подключение к управляемому серверу Eureka для Spring в Контейнеры приложений Azure

Eureka Server for Spring — это реестр служб, позволяющий микрослужбам регистрировать себя и обнаруживать другие службы. Eureka Server for Spring доступен как компонент Контейнеры приложений Azure. Вы можете привязать приложение контейнера к Eureka Server for Spring для автоматической регистрации на сервере Eureka.

В этом руководстве описано следующее:

Требуемые условия

• Учетная запись Azure с активной подпиской. Если у вас еще нет, его можно создать бесплатно.
• Azure CLI.

Рекомендации

При запуске Eureka Server for Spring in Container Apps помните о следующих сведениях:

Настройка

Прежде чем приступить к работе с компонентом Eureka Server for Spring, сначала необходимо создать необходимые ресурсы.

Создание компонента Eureka Server для Spring Java

Привязка приложения контейнера к компоненту Eureka Server for Spring Java

Вернитесь к приложению-контейнеру на портале. Скопируйте URL-адрес приложения в текстовый редактор, чтобы его можно было использовать в предстоящем шаге.

Перейдите к маршруту /allRegistrationStatus , чтобы просмотреть все приложения, зарегистрированные в компоненте Eureka Server для Spring.

Привязка внедряет несколько конфигураций в приложение в качестве переменных окружения, прежде всего свойство eureka.client.service-url.defaultZone. Это свойство указывает внутреннюю конечную точку компонента Java Eureka Server.

Привязка также внедряет следующие свойства:

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

Свойство eureka.client.register-with-eureka устанавливается в значение true для принудительного выполнения регистрации на сервере Eureka. Эта регистрация перезаписывает локальный параметр в application.properties, полученный с сервера конфигурации и так далее. Если вы хотите задать его false, можно перезаписать значение, установив переменную окружения в приложении контейнера.

Свойство eureka.instance.prefer-ip-address задано true из-за конкретного правила разрешения системы доменных имен в среде приложения контейнера. Не изменяйте это значение, чтобы не прерывать привязку.

Необязательно: Отвязать ваше приложение-контейнер от сервера Eureka для компонента Spring Java

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. Назначьте настраиваемую роль вашему аккаунту на управляемом ресурсе среды.

   Получите идентификатор ресурса управляемой среды:

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

3. Назначьте роль для вашей учетной записи.

   Перед выполнением этой команды замените заполнители в скобках <> на идентификатор пользователя, идентификатор субъекта-службы и имя роли.

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

   Примечание.

   Значение <USER_OR_SERVICE_PRINCIPAL_ID> обычно должно быть учетной записью, используемой для доступа к порталу Azure. Значением <ROLE_NAME> является имя, назначенное на шаге 1.

4. Получите URL-адрес панели мониторинга Eureka Server для Spring.

   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
   

   Эта команда возвращает URL-адрес, который можно использовать для доступа к панели мониторинга Eureka Server для Spring. С помощью панели мониторинга вы также можете увидеть приложение контейнера, как показано на следующем снимке экрана.

   

Необязательно. Интеграция компонентов Eureka Server for Spring и Admin for Spring Java

Если вы хотите интегрировать компоненты Eureka Server для Spring и Admin для компонентов Spring Java, см. раздел Интеграция управляемого администратора для Spring с Eureka Server для Spring.

Очистка ресурсов

Ресурсы, созданные в этом руководстве, влияют на ваш счёт в Azure. Если вы не собираетесь использовать эти службы в долгосрочной перспективе, выполните следующую команду, чтобы удалить все, что вы создали в этом руководстве.

az group delete --resource-group $RESOURCE_GROUP

Список разрешенных конфигураций для сервера Eureka для Spring

В следующих разделах описаны поддерживаемые конфигурации. Дополнительные сведения см. в разделе Spring Cloud Eureka Server.

Варианты конфигурации

Команда az containerapp update использует --configuration параметр для управления настройкой сервера Eureka для Spring. Вы можете одновременно использовать несколько параметров, если они разделены пробелом. Дополнительные сведения см. в разделе Spring Cloud Eureka Server.

Следующие параметры конфигурации доступны в свойстве eureka.server конфигурации:

Распространенные способы конфигурирования

• Связанные с ведением журнала конфигурации:
  • logging.level.*
  • logging.group.*
  • Любые другие конфигурации в пространстве имен logging.* должны быть запрещены - например, использование logging.file для записи файлов журнала должно быть запрещено.

Взаимодействие между приложениями

В этом примере показано, как писать Java код для вызова между приложениями, зарегистрированными в компоненте Eureka Server для Spring. Когда приложения-контейнеры привязаны к Eureka, они взаимодействуют друг с другом через сервер Eureka.

В этом примере создаются два приложения: вызывающее и принимающее. Оба приложения взаимодействуют друг с другом с помощью компонента Eureka Server для Spring. Вызываемое приложение предоставляет конечную точку, вызываемую вызывающим приложением.

1. Создайте вызываемое приложение. Включите клиент Eureka в приложении Spring Boot, добавив заметку @EnableDiscoveryClient в основной класс.

   @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. Кроме того, создайте WebClient.Builder компонент с @LoadBalanced аннотацией для выполнения вызовов с распределением нагрузки на другие сервисы.

   @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 для вызова целевого приложения с использованием имени этого приложения - callee.

   @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 для компонентов Spring Java. Убедитесь, что оба приложения запущены и привязаны к серверу Eureka перед тестированием /call-callee конечной точки в вызывающем приложении.

Ограничения

• Компонент Java Eureka Server поставляется с конфигурацией по умолчанию, eureka.server.enable-self-preservation, для параметра false. Эта конфигурация по умолчанию помогает избежать времени, когда экземпляры не удаляются после включения самосохранения. Если экземпляры удаляются слишком рано, некоторые запросы могут быть направлены на несуществующие экземпляры. Если вы хотите изменить этот параметр на true, его можно перезаписать, задав собственные конфигурации в компоненте Java.
• Панель мониторинга Eureka недоступна в Azure под управлением 21Vianet.

Следующие шаги

Связанный контент

Интеграция управляемой админ-консоли для Spring с сервером Eureka для Spring