在 Azure 容器应用 中连接到 Spring 的托管网关（预览版）

适用于 Spring 的网关提供了一种高效且强大的方法来路由、管理和处理 API 请求，作为微服务体系结构的一部分。 它充当 API 网关，用于将外部请求路由到不同的服务，并添加各种功能（例如筛选、负载均衡等）。 本文介绍如何创建将请求定向到容器应用的网关。

在本教程中，学习：

先决条件

• 具有活动订阅的Azure帐户。 如果你没有，可以免费创建一个。
• Azure CLI。

注意事项

在 Azure 容器应用 的 Gateway for Spring 中运行时，请注意以下详细信息：

安装

在开始使用 Gateway for 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	创建容器应用和Java组件的Azure区域位置。
   ENVIRONMENT	演示应用程序的Azure 容器应用环境名称。
   RESOURCE_GROUP	演示应用程序的Azure资源组名称。
   JAVA_COMPONENT_NAME	为容器应用创建的Java组件的名称。 在本例中，请为 Spring Java 组件创建网关。
   IMAGE	容器应用中使用的容器镜像。

2. 使用Azure CLI登录到Azure。

   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 组件和容器应用。

请使用用于 Spring Java 组件的网关

有了容器应用环境后，可以创建容器应用，并使用用于 Spring Java 组件的网关将请求路由到它们。

1. 创建 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> 替换为上一步中的容器应用 FQDN。

   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。 使用路径 /myapp/health 访问此 URL 应将请求路由到应用的 actuator/health 终结点，并返回 {"status":"UP","groups":["liveness","readiness"]}。

清理资源

本教程中创建的资源对Azure帐单产生影响。 如果不打算长期使用这些服务，请运行以下命令来删除本教程中创建的所有内容。

az group delete --resource-group $RESOURCE_GROUP

路由文件格式

Gateway for Spring 组件支持通过 ID、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 Gateway 允许的配置列表 (#configurable-properties)

下表介绍了可为应用配置的网关组件属性。 有关详细信息，请参阅 Spring Cloud Gateway 常见应用程序属性。

常见配置

以下列表描述了常见配置：

• 日志记录相关配置：
  • logging.level.*
  • logging.group.*
  • 应禁止 logging.* 命名空间下的任何其他配置。 例如，应禁止使用 logging.file 写入日志文件。