Higress 基于自定义插件访问 Redis

时间:2024-10-21 17:38:15

简介

基于 wasm 机制,Higress 提供了优秀的可扩展性,用户可以基于 Go/C++/Rust 编写 wasm 插件,自定义请求处理逻辑,满足用户的个性化需求,目前插件已经支持 redis 调用,使得用户能够编写有状态的插件,进一步提高了 Higress 的扩展能力。

文档在插件中调用 Redis[1]中提供了完整的网关通过插件调用 Redis 的例子,包括阿里云 Redis 实例创建与配置、插件代码编写、插件上传与配置、测试样例等流程。接下来本文重点介绍几个基于 Redis 的插件。

多网关全局限流

网关已经提供了 sentinal 限流[2],能够有效保护后端业务应用。通过 redis 插件限流,用户可以实现多网关的全局限额管理。

以下为插件代码示例,在请求头阶段检查当前时间内请求次数,如果超出配额,则直接返回 429 响应。

  1. func onHttpRequestHeaders(ctx , config RedisCallConfig, log ) {
  2. now := time.Now()
  3. minuteAligned := (time.Minute)
  4. timeStamp := (x(), 10)
  5. // 如果 redis api 返回的 err != nil,一般是由于网关找不到 redis 后端服务,请检查是否误删除了 redis 后端服务
  6. err := (timeStamp, func(response resp.Value) {
  7. if response.Error() != nil {
  8. ("call redis error: %v", response.Error())
  9. ()
  10. } else {
  11. ("timeStamp", timeStamp)
  12. ("callTimeLeft", (()))
  13. if () == 1 {
  14. err := (timeStamp, 60, func(response resp.Value) {
  15. if response.Error() != nil {
  16. ("call redis error: %v", response.Error())
  17. }
  18. ()
  19. })
  20. if err != nil {
  21. ("Error occured while calling redis, it seems cannot find the redis cluster.")
  22. ()
  23. }
  24. } else {
  25. if () > {
  26. (429, [][2]string{{"timeStamp", timeStamp}, {"callTimeLeft", "0"}}, []byte("Too many requests\n"), -1)
  27. } else {
  28. ()
  29. }
  30. }
  31. }
  32. })
  33. if err != nil {
  34. // 由于调用redis失败,放行请求,记录日志
  35. ("Error occured while calling redis, it seems cannot find the redis cluster.")
  36. return
  37. } else {
  38. // 请求hold住,等待redis调用完成
  39. return
  40. }
  41. }

插件配置如下:

测试结果如下:

结合通义千问实现 token 限流

对于提供 AI 应用服务的开发者来说,用户的 token 配额管理是一个非常关键的功能,以下例子展示了如何通过网关插件实现对通义千问后端服务的 token 限流功能。

首先需要申请通义千问的 API 访问,可参考此链接[3]。之后在 MSE 网关配置相应服务以及路由,如下所示:

编写插件代码,插件中,在响应 body 阶段去写入该请求使用的 token 额度,在处理请求头阶段去读 redis 检查当前剩余 token 额度,如果已经没有 token 额度,则直接返回响应,中止请求。

  1. func onHttpRequestBody(ctx , config TokenLimiterConfig, body []byte, log ) {
  2. now := time.Now()
  3. minuteAligned := (time.Minute)
  4. timeStamp := (x(), 10)
  5. .Get(timeStamp, func(response resp.Value) {
  6. if response.Error() != nil {
  7. defer ()
  8. ("Error occured while calling redis")
  9. } else {
  10. tokenUsed := ()
  11. if < tokenUsed {
  12. (429, [][2]string{{"timeStamp", timeStamp}, {"TokenLeft", ( - tokenUsed)}}, []byte("No token left\n"), -1)
  13. } else {
  14. ()
  15. }
  16. }
  17. })
  18. return
  19. }
  20. func onHttpResponseBody(ctx , config TokenLimiterConfig, body []byte, log ) {
  21. now := time.Now()
  22. minuteAligned := (time.Minute)
  23. timeStamp := (x(), 10)
  24. tokens := int((body).Get("usage").Get("total_tokens").Int())
  25. (timeStamp, tokens, func(response resp.Value) {
  26. if response.Error() != nil {
  27. defer ()
  28. ("Error occured while calling redis")
  29. } else {
  30. if () == tokens {
  31. (timeStamp, 60, func(response resp.Value) {
  32. defer ()
  33. if response.Error() != nil {
  34. ("Error occured while calling redis")
  35. }
  36. })
  37. }
  38. }
  39. })
  40. return
  41. }

测试结果如下:

基于 cookie 的缓存、容灾以及会话管理

除了以上两个限流的例子,基于 Redis 可以实现更多的插件对网关进行扩展。例如基于 cookie 来做缓存、容灾以及会话管理等功能。

  • 缓存&容灾:基于用户 cookie 信息缓存请求应答,一方面能够减轻后端服务压力,另一方面,当后端服务不可用时,能够实现容灾效果。
  • 会话管理:使用 Redis 存储用户的认证鉴权信息,当请求到来时,先访问 redis 查看当前用户是否被授权访问,如果未被授权再去访问认证鉴权服务,可以减轻认证鉴权服务的压力。
  1. func onHttpRequestHeaders(ctx , config HelloWorldConfig, log ) {
  2. cookieHeader, err := ("cookie")
  3. if err != nil {
  4. ("error getting cookie header: %v", err)
  5. // 实现自己的业务逻辑
  6. }
  7. // 根据自己需要对cookie进行处理
  8. cookie := CookieHandler(cookieHeader)
  9. .Get(cookie, func(response resp.Value) {
  10. if response.Error() != nil {
  11. ("Error occured while calling redis")
  12. ()
  13. } else {
  14. // 实现自己的业务逻辑
  15. ()
  16. }
  17. })
  18. return
  19. }

总结

Higress 通过支持 redis 调用,大大增强了插件的能力,使插件功能具有更广阔的想象空间,更加能够适应开发者多样的个性化需求,如果大家有更多关于 Higress 的想法与建议,欢迎与我们联系!

相关链接:

[1] 在插件中调用 Redis

/zh/mse/user-guide/develop-gateway-plug-ins-by-using-the-go-language?spm=a2c4g.11186623.0.0.45a53597EVVAC0#5e5a601af18al

[2] sentinal 限流

/zh/mse/user-guide/configure-a-throttling-policy?spm=a2c4g.11186623.0.i4

[3] 链接

/zh/dashscope/developer-reference/api-details?spm=a2c4g.11186623.0.i4#602895ef3dtl1

作者: 钰诚

原文链接

本文为阿里云原创内容,未经允许不得转载。