跳到主要内容
版本:3.8.x

设置路由优先级和匹配条件(Ingress Controller)

API7 Gateway 支持配置路由优先级和高级匹配条件,以控制请求如何路由到后端服务。

本教程介绍如何使用 API7 Ingress Controller 定义路由优先级和匹配规则,实现基于请求头、查询参数等条件的精细请求路由。

前置要求​

  1. 安装 API7 企业版。
  2. 安装 API7 Ingress Controller 并启动网关。

配置路由和规则​

创建用于 HTTPRoute 的 Kubernetes 清单文件:

httpbin-route.yaml
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
namespace: api7
name: httpbin
spec:
parentRefs:
- name: apisix
rules:
- matches:
- path:
type: PathPrefix
value: /*
backendRefs:
- name: httpbin
port: 80

再创建一个 Kubernetes 清单文件,为目标 HTTPRoute 配置路由优先级和请求匹配条件:

route-policy.yaml
apiVersion: apisix.apache.org/v1alpha1
kind: HTTPRoutePolicy
metadata:
namespace: api7
name: http-route-policy
spec:
targetRefs:
- group: gateway.networking.k8s.io
kind: HTTPRoute
name: httpbin
priority: 10
vars:
- - http_x_test_name
- ==
- http-route-policy
- - arg_test
- ==
- http-route-policy

❶ 将 name 配置为目标 HTTPRoute 的元数据名称。

❷ 配置目标 HTTPRoute 的优先级。数值越大,优先级越高。

❸ 匹配带有 HTTP 请求头 X-Test-Name: http-route-policy 的请求。

❹ 匹配带有查询参数 test=http-route-policy 的请求。

只有 vars 中的两个条件都满足时,请求才会匹配到此路由。有关这些表达式的更多信息,请参阅内置变量和 API7 表达式。

将配置应用到集群:

kubectl apply -f httpbin-route.yaml -f route-policy.yaml

配置多个目标​

如果要将策略应用到多个 HTTPRoute 中的路由,可以配置更多目标:

route-policy.yaml
apiVersion: apisix.apache.org/v1alpha1
kind: HTTPRoutePolicy
metadata:
namespace: api7
name: http-route-policy
spec:
targetRefs:
- group: gateway.networking.k8s.io
kind: HTTPRoute
name: httpbin
- group: gateway.networking.k8s.io
kind: HTTPRoute
name: httpbin-1
priority: 10
vars:
- - http_x_test_name
- ==
- http-route-policy
- - arg_test
- ==
- http-route-policy

验证​

通过端口转发将网关服务端口暴露到本机:

kubectl port-forward svc/api7-ee-3-gateway-gateway 9081:9081 &

发送一个不满足任何条件的请求:

curl "http://127.0.0.1:9080/ip"

应收到 HTTP/1.1 404 Not Found 响应。

再发送一个满足其中一个条件的请求:

curl "http://127.0.0.1:9080/ip?test=http-route-policy"

也应收到 HTTP/1.1 404 Not Found 响应。

最后,发送一个满足所有条件的请求:

curl "http://127.0.0.1:9080/ip?test=http-route-policy" -H "X-Test-Name: http-route-policy"

应收到类似以下的响应:

{
"origin": "127.0.0.1"
}