External Plugin

    当你在 APISIX 中配置了一个 Plugin Runner ,APISIX 将以子进程的方式运行该 Plugin Runner 。 该子进程与 APISIX 进程从属相同用户。当重启或者重新加载 APISIX 时,该 Plugin Runner 也将被重启。

    一旦你为指定路由配置了 ext-plugin-* 插件, 匹配该路由的请求将触发从 APISIX 到 Plugin Runner 的 RPC 调用。

    Plugin Runner 将处理该 RPC 调用,在其侧创建一个请求,运行 External Plugin 并将结果返回给 APISIX 。

    External Plugin 及其执行顺序在这里 ext-plugin-* 配置。与其他插件一样, External Plugin 可以动态启用和重新配置。

    APISIX 将以子进程的方式管理该 Plugin Runner 。

    注意:在 Mac 上,APISIX v2.6 无法管理该 Plugin Runner 。

    在开发过程中,我们希望单独运行 Plugin Runner ,这样就可以重新启动它,而无需先重新启动 APISIX 。

    通过指定环境变量 APISIX_LISTEN_ADDRESS, 我们可以使 Plugin Runner 监听一个固定的地址。 例如:

    此时, Plugin Runner 将监听 /tmp/x.sock

    在生产环境,不应该使用 ,此时监听的地址将动态生成。

    v2.7,APISIX 可以将环境变量传递给 Plugin Runner 。

    然而,默认情况下,Nginx 将隐藏所有环境变量。所以你需要首先在 conf/config.yaml 中声明环境变量:

    APISIX 使用 SIGKILL 终止 Plugin Runner ,而不是使用 SIGTERM!

    v2.7,当跑在 OpenResty 1.19+ 时,APISIX 将使用 SIGTERM 来停止 Plugin Runner 。

    但是,APISIX 需要等待 Plugin Runner 退出,这样我们才能确保资源得以被释放。