共用方式為

使用適用於容器的應用程式閘道進行路徑、標頭和查詢字串路由 - 閘道 API

本檔可協助您設定範例應用程式，以使用閘道 API 中的資源來示範以 URL 路徑、查詢字串和標頭為基礎的流量路由。 其中提供下列作業的步驟：

  • 建立具有一個 HTTPS 接聽程式的 閘道 資源。
  • 建立參考後端服務的 HTTPRoute 資源。
  • 使用 HTTPRouteMatch 根據路徑、標頭和查詢字串來執行 matches 該路由。

背景

容器的應用程式網關會根據 URL 路徑、查詢字串和標頭來啟用流量路由。 請查看下列範例案例：

此圖顯示容器應用程式閘道中的路徑、標頭和查詢字串路由。

先決條件

  1. 如果遵循 BYO 部署策略，請確定已設定了適用於容器的應用程式閘道和 ALB 控制器

  2. 如果遵循 ALB 受控部署策略，請確定您已透過 ApplicationLoadBalancer 自訂資源佈建了 ALB 控制器，以及適用於容器的應用程式閘道。

  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 Resource Manager 中建立容器資源的應用程式閘道時，它會針對前端資源使用下列命名慣例： 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 上的 backend-v2 服務
  2. 如果請求包含名稱為 magic、值為 foo 的 HTTP 標頭，並且 URL 包含定義名稱 great 的值為 example 的查詢字串，且路徑為 /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

小提示

適用於容器的應用程式閘道器支援使用規則運算式 2（RE2）語法進行 headers、queryParams 和 path 規則的規則運算式比對。 如需詳細資訊，請參閱 閘道 API 規格。

建立 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。

查詢字串 + 標頭 + 路徑路由

在此案例中，將包含「magic: foo」標頭欄位的用戶端請求傳送到 http://frontend-fqdn/some/thing?great=example，且會路由到 backend-v2 服務。

執行下列命令：

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

請注意，提供要求的容器是 backend-v2。

預設路由

如果前兩個案例都未滿足，容器的應用程式網關會將所有其他要求路由傳送至 backend-v1 服務。

執行下列命令：

curl http://$fqdn/

請注意，提供要求的容器是 backend-v1。

恭喜，您已安裝 ALB 控制器、部署後端應用程式，並透過適用於容器的應用程式閘道上的閘道 API 將流量路由傳送至應用程式。

  • Last updated on