设置路由优先级和匹配条件(Ingress Controller)
API7 Gateway 支持配置路由优先级和高级匹配条件,以控制请求如何路由到后端服务。
本教程介绍如何使用 API7 Ingress Controller 定义路由优先级和匹配规则,实现基于请求头、查询参数等条件的精细请求路由。
前置要求
- 安装 API7 企业版。
- 安装 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"
}