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

Шлюз для Spring предлагает эффективный и эффективный способ маршрутизации, управления и обработки запросов API в рамках архитектуры микрослужб. Он служит шлюзом API, который направляет внешние запросы в разные службы, добавляя различные возможности, такие как фильтрация, балансировка нагрузки и многое другое. Из этой статьи вы узнаете, как создать шлюз, который направляет запросы к приложениям контейнеров.

Из этого руководства вы узнаете, как:

Предварительные требования

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

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

При запуске шлюза для Spring в Контейнеры приложений Azure помните о следующих сведениях:

Настройка

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

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

1. Создайте переменные для поддержки конфигурации приложения. Эти значения предоставляются для вас в целях этого урока. В этом занятии мы используем конечную точку актатора администратора для примера приложения spring.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=mygateway
   export APP_NAME=myapp
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Переменная	Описание
   LOCATION	Местоположение региона Azure, где вы создаете приложение-контейнер и компонент Java.
   ENVIRONMENT	Имя среды Контейнеры приложений Azure для демонстрационного приложения.
   RESOURCE_GROUP	Имя группы ресурсов Azure для демонстрационного приложения.
   JAVA_COMPONENT_NAME	Имя компонента Java, созданного для приложения контейнера. В этом случае создается компонент Gateway for Spring Java.
   IMAGE	Образ контейнера, используемый в контейнерном приложении.

2. Войдите в Azure с помощью Azure CLI.

   az login
   

3. Создать группу ресурсов.

   az group create --name $RESOURCE_GROUP --location $LOCATION
   

4. Создайте среду приложений контейнеров.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

   Эта среда используется для размещения компонента Gateway for Spring и приложения контейнера.

Использование компонента Gateway for Spring Java

Теперь, когда у вас есть среда для контейнерных приложений, вы можете создать приложение-контейнер, используя шлюз с компонентами Java Spring для маршрутизации запросов к ним.

1. Создайте компонент Gateway for Spring Java.

   az containerapp env java-component gateway-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
   

2. Создайте приложение-контейнер с полным доменным именем (FQDN).

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --ingress external \
       --target-port 8080 \
       --query properties.configuration.ingress.fqdn
   

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

Обновление маршрутов шлюза для маршрутизации запросов

1. Создайте ФАЙЛ YAML со следующим содержимым. Замените <MYAPP_URL> полное доменное имя приложения-контейнера на предыдущем шаге.

   springCloudGatewayRoutes:
   - id: "route1"
     uri: "<MYAPP_URL>"
     predicates:
       - "Path=/myapp/{path}"
     filters:
       - "SetPath=/actuator/{path}"
   

2. Выполните следующую команду, чтобы обновить компонент Gateway for Spring с конфигурацией маршрута.

   az containerapp env java-component gateway-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \ 
       --route-yaml <PTAH_TO_ROUTE_YAML_FILE> \
       --query properties.ingress.fqdn
   

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

   Команда возвращает URL-адрес шлюза. Посетите этот URL-адрес с путем /myapp/health, который должен перенаправлять запрос на конечную точку вашего приложения actuator/health, возвращая {"status":"UP","groups":["liveness","readiness"]}.

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

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

az group delete --resource-group $RESOURCE_GROUP

Формат файла маршрута

Компонент Gateway for Spring поддерживает определение маршрутов через свойства с идентификаторами, URI, предикатами и фильтрами. Дополнительные сведения см. в документации по Spring Cloud Gateway. Ниже приведен пример YAML-файла, демонстрирующего настройку этих свойств.

  springCloudGatewayRoutes:
  - id: "route1"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v1/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"
  - id: "route2"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v2/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"

Список разрешенных конфигураций для шлюза для Spring(#configurable-properties)

В следующей таблице описаны свойства компонента шлюза, которые можно настроить для приложения. Дополнительные сведения см. в разделе Свойств общего приложения Spring Cloud Gateway.

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

В следующем списке описаны распространенные конфигурации:

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