apisix lua插件开发记录

1 如何匹配路径中的参数

文章给出了具体的方法,但有隐藏的坑未提及。

router radixtree_uri_with_parameter 启用后,对路径上的参数名有要求,不能有_。否则会提示404,因为 router radixtree_uri_with_parameter解析不了。

2 插件中的默认参数未生效

经过插件的请求的各拦截点见官方文档:https://apisix.apache.org/docs/apisix/architecture-design/apisix/

lua插件的关键组成

  1. require
  2. schema 插件的规约,apisix根据 schema处理插件的配置。
  3. name 定义插件的名称
  4. _M 定义的一个lua的module,最终返回给框架层。
  5. _M.check_schema 检查schema,对conf设置默认值。
  6. _M.access 检查进入的请求,根据不同的需求,实现不同步骤的拦截接口,如proxy、rewrite等

一开始未理解check_schema的作用,未实现它,结果发现在schema中定义的默认参数并没有生效。实现这个函数就行了。

复制代码
function _M.check_schema(conf)
    return core.schema.check(schema, conf)
end

官方文档也没描述默认参数的处理。因为它从命令看,只是为了检查配置是否符合schema。

3 请求提前返回中止

在 access 中完成检查后,我直接return 200, "ok"了。结果请求未到后端服务。想要请求继续到后端服务,要只return。不返回具体的状态码。

至少我没在apisix官网没找到对应的文档。文档只说了不要提前返回,继续请求应该返回什么,并没有准确的描述。

4 使用ingress-controller时,路由CR如何生效

一开始不知道如何生效,后来想可能需要重启ingress-controller,果然重启一下就可以了。

复制代码
kubectl rollout restart deploy apisix-ingress-controller

5 日志

apisix的默认日志等级是warn级别,也就是说你在lua中加的info级别是在apisix日志中看不到。

6 lua脚本修改生效

目前看apisix并不支持这种热加载。需要重启apisix容器,但脚本都是在容器镜像里的。所以调试时,需要反复打镜像,效率并不高。

可以这样:把脚本的目录挂载到Pod里,然后修改脚本后,重启Pod就行了。注意重启顺序:

  1. 重启 apisix,让脚本生效。
  2. 重启 apisix-ingress-controller 让路由生效。
相关推荐
慢慢沉7 小时前
Lua(数据库访问)
开发语言·数据库·lua
慢慢沉7 小时前
Lua协同程序(coroutine)
lua
慢慢沉1 天前
Lua元表(Metatable)
lua
慢慢沉2 天前
Lua(字符串)
开发语言·lua
慢慢沉2 天前
Lua(数组)
开发语言·lua
慢慢沉2 天前
Lua(迭代器)
开发语言·lua
慢慢沉2 天前
Lua基本语法
开发语言·lua
Feng.Lee2 天前
接口测试Postman工具高级使用技巧
功能测试·测试工具·lua·postman·可用性测试
三翼鸟数字化技术团队3 天前
鸿蒙平台运行Lua脚本
lua·harmonyos