基于docker的apisix网关的java插件开发

基于docker的apisix网关的java插件开发

作者: fitz_i，未经博主允许不得转载。经许可的转载需注明作者和博客主页：https://blog.csdn.net/fitz_i

关于JDK版本

java运行及maven打包环境的jdk 均为jdk11 ，切记！

一、搭建docker环境

​ 在安装目录下，克隆apisix官方的docker示例文件:

git clone https://github.com/apache/apisix-docker.git

​ 拉取后进入

cd apisix-docker/example

​ 可得到以下文件：

​

二、搭建分层镜像

​ apisix服务与java插件中通信是基于某个.sock的文件，所以官网给出这样的解释：

​ 这意味着在docker里搭建的apisix容器，同时也需要有java的运行环境，才可以进行java插件的开发。

​ 由于apisix的java插件开发需要继续 jdk11，并且刚才example目录下的docker-comse.yaml中，apisix的基础镜像并没有带jdk，所以这里我们搭建一个新的docker镜像。

​ 前往oracle官网下载jdk-11，并将其拷贝至宿主机，与Dockerfile同级目录。

​ 开始编写Dockerfile文件，来构建一个定制化的镜像。

# 路径自己选择
vim Dockerfile

#进入文件后
#依赖镜像名称和ID
FROM apache/apisix:2.13.1-centos
#指定镜像创建者信息
MAINTAINER cisco
#将宿主机的文件拷贝到容器的具体目录中。这里使用ADD，拷贝后自动解压，如果不需要解压，可以使用COPY
ADD jdk-11.0.15_linux-x64_bin.tar.gz /jdk
## 配置jdk环境
ENV JAVA_HOME /jdk/jdk-11.0.15
ENV PATH ${JAVA_HOME}/bin:$PATH

​ 这里选择的镜像源是apache/apisix:2.13.1-centos

​ 最开始使用的是官网的apache/apisix:2.14.1-alpine，由于alpine源的原因, 在后续的开发的时候碰到了一些问题, 这里我们避免后续其他的“坑”，采用centos的。

​ 继续在当前目录构建镜像

docker build -t apisix-jdk11 .

​

​ 构建成功后，得到一个名为apisix-jdk11:latest的新镜像。返回到example目录，修改docker-compose.yaml内的 apisix镜像名。

​ 执行

docker-compose -f docker-compose.yml up -d

​ 此阶段可检查有无端口冲突，及处理。

​ 查看docker容器运行状态

docker ps -a

​ 无异常即可访问 http://宿主机ip:9000, 访问APISIX DashBoard，进行对应操作及配置。

三、基于Java的Ext-Plugin开发

​ 可参考官网的文档: https://apisix.apache.org/docs/java-plugin-runner/next/development

​ 给插件命名为TestExtPluginDemo，插件属性如下

{
  "validate_header": "token",
  "rejected_code": "403"
}

​ 在APISIX上配置一个路由/get，指定该路由需要使用的外部插件

curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "uri":"/get",
    "plugins":{
        "ext-plugin-pre-req":{
            "conf":[
                {
                    "name":"TestExtPluginDemo",
                    "value":"{\"validate_header\":\"token\",\"rejected_code\":\"403\"}"
                }
            ]
        }
    },
    "upstream":{
        "nodes":{
            "httpbin.org:80":1
        },
        "type":"roundrobin"
    }
}
 

​ 需要注意的是，TestExtPluginDemo 的属性需要经过 json 转义，作为 string 类型进行配置。

​ （这里上游地址配置为 httpbin.org，方便调试）

​

​ 克隆apisix-java-plugin-runner项目。

​ 在runner-plugin模块中，org.apache.apisix.plugin.runner.filter的路径下编写插件。

​

​ 在此路径下创建插件类，需实现PluginFilter接口，其中name()的返回值，将作为apisix的插件名称。

package org.apache.apisix.plugin.runner.filter;

import com.google.gson.Gson;
import org.apache.apisix.plugin.runner.HttpRequest;
import org.apache.apisix.plugin.runner.HttpResponse;
import org.apache.logging.log4j.util.Strings;
import org.springframework.stereotype.Component;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * @Description:
 * @Author: cisco
 * @Date: 2022/6/22 11:25
 */
@Component
public class TestExtPluginDemo implements PluginFilter {

    @Override
    public String name() {
        //此处返回值为插件的名称
        return "TestExtPluginDemo";
    }

    @Override
    public void filter(HttpRequest request, HttpResponse response, PluginFilterChain chain) {
        // parse `conf` to json
        String configStr = request.getConfig(this);
        Gson gson = new Gson();
        Map<String, Object> conf = new HashMap<>();
        conf = gson.fromJson(configStr, conf.getClass());

        // get configuration parameters
        String token = request.getHeader((String) conf.get("validate_header"));

        // token verification results
        if (!Strings.isNotBlank(token)) {
            String rejectedCode = (String) conf.get("rejected_code");
            response.setStatusCode(Integer.parseInt(rejectedCode));
            chain.filter(request, response);
        }
        chain.filter(request, response);
    }

    @Override
    public List<String> requiredVars() {
        return null;
    }

    @Override
    public Boolean requiredBody() {
        return null;
    }
}

​ 编写完插件后，对项目进行打包。IDEA用户可以直接使用maven工具

./mvnw install
#或者
./mvnw package

​ 然后你会看到dist目录下，生成一个apache-apisix-java-plugin-runner-0.2.0-bin.tar.gz

​ 将其复制到docker的宿主机上，进行解压。再将解压后的jar包通过docker cp命令 复制到 docker容器内部

tar -xvf apache-apisix-java-plugin-runner-0.2.0-bin.tar.gz
docker cp apisix-java-plugin-runner.jar apisix-11:/opt/

​ 修改外部挂载的 APISIX配置文件。位于apisix-docker/exaple/apisix_conf文件夹中的config.yaml

​ 添加如下配置：

ext-plugin:
  cmd: ['java', '-jar', '/opt/apisix-runner-bin/apisix-java-plugin-runner.jar']

​ 重启docker容器，进行测试。使用之前配置使用此插件的路由。

 curl -H 'token: 123456' 192.168.56.102:9080/get
 curl 192.168.56.102:9080/get

​ 执行结果如下：

通过返回报文可知，java插件已生效。
觉得本文有用的话 点赞收藏支持一下，谢谢!