通过

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

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

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

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

背景

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

显示包含用于容器的应用程序网关的路径、标头和查询字符串路由的图。

先决条件

  1. 如果遵循 BYO 部署策略，请确保设置适用于容器的应用程序网关资源和ALB 控制器

  2. 如果遵循 ALB 托管部署策略，请确保已预配ALB 控制器，并已通过 ApplicationLoadBalancer 自定义资源预配了适用于容器的应用程序网关。

  3. 部署示例 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的命名空间
    • backend-v1命名空间中名为backend-v2和test-infra的两个服务
    • backend-v1 命名空间中名为 backend-v2 和 test-infra 的两个部署

部署所需的网关 API 资源

创建网关：

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 控制器在 Azure 资源管理器中为容器资源创建应用程序网关时，它将对前端资源使用以下命名约定： fe-<eight randomly generated characters>

若要更改在 Azure 中创建的前端资源的名称，请考虑遵循 自带部署策略。

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

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 以定义两个不同的匹配项，以及用于将流量路由到的默认服务。

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

  1. 如果路径为 /bar，流量将路由到端口 8080 OR 上的后端 v2 服务
  2. 如果请求包含名称 magic 和值 foo 的 HTTP 标头，则 URL 包含一个查询字符串，该字符串定义名称伟大的示例值，路径为 /some/thing，则请求将发送到端口 8080 上的 backend-v2。
  3. 否则，所有其他请求将路由到端口 8080 上的后端 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 的客户端请求将路由到后端 v2 服务。

运行下面的命令：

curl http://$fqdn/bar

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

查询字符串 + 标头 + 路径路由

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

运行下面的命令：

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

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

默认路由

如果前两种方案均未满足，则用于容器的应用程序网关会将所有其他请求路由到后端 v1 服务。

运行下面的命令：

curl http://$fqdn/

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

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