你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用适用于容器的应用程序网关进行路径、标头和查询字符串路由 - 网关 API

项目
11/05/2024

本文档帮助你设置一个示例应用程序，该应用程序使用网关 API 中的资源来演示基于 URL 路径、查询字符串和标头的流量路由。下面是步骤：

使用一个 HTTPS 侦听器创建网关资源。
创建引用后端服务的 HTTPRoute 资源。
使用 HTTPRouteMatch 执行根据路径、标头和查询字符串进行路由的 matches。

背景

容器应用程序网关支持基于 URL 路径、查询字符串和标头的流量路由。请参阅以下示例场景：

图片显示了使用适用于容器的应用程序网关进行路径、标头和查询字符串路由。

先决条件

如果遵循 BYO 部署策略，请确保设置适用于容器的应用程序网关资源和ALB 控制器
如果遵循 ALB 托管部署策略，请确保已预配 ALB 控制器，并通过 ApplicationLoadBalancer 自定义资源预配适用于容器的应用程序网关。
部署示例 HTTP 应用程序。在群集上应用以下deployment.yaml 文件来创建示例 Web 应用程序，以演示基于路径、查询和标头的路由。
```
kubectl apply -f https://raw.githubusercontent.com/MicrosoftDocs/azure-docs/refs/heads/main/articles/application-gateway/for-containers/examples/traffic-split-scenario/deployment.yaml
```
此命令在群集上创建以下内容：
- 名为test-infra的命名空间
- test-infra命名空间中名为backend-v1和backend-v2的两个服务
- test-infra命名空间中名为backend-v1和backend-v2的两个部署

创建网关：

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1beta1
kind: Gateway
metadata:
  name: gateway-01
  namespace: test-infra
  annotations:
    alb.networking.azure.io/alb-namespace: alb-test-infra
    alb.networking.azure.io/alb-name: alb-test
spec:
  gatewayClassName: azure-alb-external
  listeners:
  - name: http-listener
    port: 80
    protocol: HTTP
    allowedRoutes:
      namespaces:
        from: Same
EOF

注意

当 ALB 控制器在 ARM 中创建适用于容器的应用程序网关时，它将对前端资源使用以下命名约定：fe-<8 个随机生成的字符>

如果要更改在 Azure 中创建的前端的名称，请考虑按照创建自己的部署策略中的说明进行操作。

设置以下环境变量

RESOURCE_GROUP='<resource group name of the Application Gateway For Containers resource>'
RESOURCE_NAME='alb-test'

RESOURCE_ID=$(az network alb show --resource-group $RESOURCE_GROUP --name $RESOURCE_NAME --query id -o tsv)
FRONTEND_NAME='frontend'

创建网关

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1beta1
kind: Gateway
metadata:
  name: gateway-01
  namespace: test-infra
  annotations:
    alb.networking.azure.io/alb-id: $RESOURCE_ID
spec:
  gatewayClassName: azure-alb-external
  listeners:
  - name: http-listener
    port: 80
    protocol: HTTP
    allowedRoutes:
      namespaces:
        from: Same
  addresses:
  - type: alb.networking.azure.io/alb-frontend
    value: $FRONTEND_NAME
EOF

创建网关资源后，请确保状态有效，侦听器已编程，并地址已分配给网关。

kubectl get gateway gateway-01 -n test-infra -o yaml

成功创建网关的示例输出。

status:
  addresses:
  - type: Hostname
    value: xxxx.yyyy.alb.azure.com
  conditions:
  - lastTransitionTime: "2023-06-19T21:04:55Z"
    message: Valid Gateway
    observedGeneration: 1
    reason: Accepted
    status: "True"
    type: Accepted
  - lastTransitionTime: "2023-06-19T21:04:55Z"
    message: Application Gateway For Containers resource has been successfully updated.
    observedGeneration: 1
    reason: Programmed
    status: "True"
    type: Programmed
  listeners:
  - attachedRoutes: 0
    conditions:
    - lastTransitionTime: "2023-06-19T21:04:55Z"
      message: ""
      observedGeneration: 1
      reason: ResolvedRefs
      status: "True"
      type: ResolvedRefs
    - lastTransitionTime: "2023-06-19T21:04:55Z"
      message: Listener is accepted
      observedGeneration: 1
      reason: Accepted
      status: "True"
      type: Accepted
    - lastTransitionTime: "2023-06-19T21:04:55Z"
      message: Application Gateway For Containers resource has been successfully updated.
      observedGeneration: 1
      reason: Programmed
      status: "True"
      type: Programmed
    name: https-listener
    supportedKinds:
    - group: gateway.networking.k8s.io
      kind: HTTPRoute

创建网关后，创建一个 HTTPRoute 来定义两个不同的匹配项和一个将流量路由到的默认服务。

以下规则的读取方式如下：

如果路径为 /bar，流量将路由到端口 8080 上的 backend-v2 服务，或者
如果请求包含名称为 magic 且值为 foo 的 HTTP 标头，该 URL 包含一个查询字符串，该查询字符串将准确定义名称且包含示例值，并且路径为 /some/thing，则请求将发送至端口 8080 上的 backend-v2。
否则，所有其他请求都将路由到端口 8080 上的 backend-v1 服务。

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1beta1
kind: HTTPRoute
metadata:
  name: http-route
  namespace: test-infra
spec:
  parentRefs:
  - name: gateway-01
    namespace: test-infra
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /bar
    backendRefs:
    - name: backend-v2
      port: 8080
  - matches:
    - headers:
      - type: Exact
        name: magic
        value: foo
      queryParams:
      - type: Exact
        name: great
        value: example
      path:
        type: PathPrefix
        value: /some/thing
      method: GET
    backendRefs:
    - name: backend-v2
      port: 8080
  - backendRefs:
    - name: backend-v1
      port: 8080
EOF

创建 HTTPRoute 资源后，请确保路由已接受，并且适用于容器的应用程序网关已编程。

kubectl get httproute http-route -n test-infra -o yaml

验证是否已成功更新适用于容器的应用程序网关资源的状态。

status:
  parents:
  - conditions:
    - lastTransitionTime: "2023-06-19T22:18:23Z"
      message: ""
      observedGeneration: 1
      reason: ResolvedRefs
      status: "True"
      type: ResolvedRefs
    - lastTransitionTime: "2023-06-19T22:18:23Z"
      message: Route is Accepted
      observedGeneration: 1
      reason: Accepted
      status: "True"
      type: Accepted
    - lastTransitionTime: "2023-06-19T22:18:23Z"
      message: Application Gateway For Containers resource has been successfully updated.
      observedGeneration: 1
      reason: Programmed
      status: "True"
      type: Programmed
    controllerName: alb.networking.azure.io/alb-controller
    parentRef:
      group: gateway.networking.k8s.io
      kind: Gateway
      name: gateway-01
      namespace: test-infra

测试对应用程序的访问

现在，我们已准备好通过分配给前端的 FQDN 将一些流量发送到示例应用程序。使用以下命令获取 FQDN。

fqdn=$(kubectl get gateway gateway-01 -n test-infra -o jsonpath='{.status.addresses[0].value}')

通过使用 curl 命令，我们可以验证三种不同的场景：

基于路径的路由

在此场景中，发送到 http://frontend-fqdn/bar 的客户端请求将路由到 backend-v2 服务。

运行以下命令：

curl http://$fqdn/bar

请注意，为请求提供服务的容器是 backend-v2。

在此场景中，发送到 http://frontend-fqdn/some/thing?great=example 且标头键/值部分为“magic: foo”的客户端请求将路由到 backend-v2 服务。

运行以下命令：

curl http://$fqdn/some/thing?great=example -H "magic: foo"

请注意，为请求提供服务的容器是 backend-v2。

默认路由

如果前两种场景都不满足，容器应用程序网关会将所有其他请求路由到 backend-v1 服务。

运行下面的命令：

curl http://$fqdn/

请注意，为请求提供服务的容器是 backend-v1。

恭喜，你已安装 ALB 控制器，部署了后端应用程序，并通过适用于容器的应用程序网关上的网关 API 将流量路由到应用程序。

通过