apisix docker镜像构建及插件化开发

高能劝退：lua开发，适合小白看！！！

前段时间有个项目，用的java程序做网关，压测tps只有1k多点，惨不忍睹。

后来公司有个大佬改用apisix做网关，tps飙升到1w多。

于是对神奇的apisix产生了浓厚的崇敬之情。感兴趣之余，便学习了一点apisix的插件开发。

当然，只是一些入门基本的开发。源码什么的肯定看不懂。

docker构建

为了开发方便，这里用了docker。可以选择自己构建，也可以从dockerhub拉取我构建好的

docker pull xshower/apisix:centos8

自己构建一个apisix的docker镜像，Dockerfile内容如下

FROM centos:8

MAINTAINER xShower<https://gitee.com/syher>

ARG APISIX_VERSION=1.5

LABEL apisix_version="${APISIX_VERSION}"

RUN yum -y install yum-utils gcc automake autoconf libtool make \

	&& yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo \

	&& yum install -y openresty \

	&& yum install -y https://github.com/apache/apisix/releases/download/$APISIX_VERSION/apisix-$APISIX_VERSION-0.el7.noarch.rpm \

	&& yum clean all \

	&& sed -i 's/PASS_MAX_DAYS\t99999/PASS_MAX_DAYS\t60/g' /etc/login.defs

ADD entrypoint.sh .

ADD apisix-dashboard.tar /usr/local/apisix/

WORKDIR /usr/local/apisix

ENTRYPOINT sh /entrypoint.sh && /bin/bash

基于centos8构建了最基础的apisix镜像，apisix-dashboard.tar是apisix的webui。需要自己解压到apisix的安装目录。

镜像构建完以后会执行entrypoint.sh脚本。

#! /bin/sh

INIT_DIR=/prepare-init.d

LUAROCKS_DIR=/usr/local/apisix/third

function run_script() {

    sh script_file

}

# 执行$INIT_DIR中的shell脚本

function init() {

    run_script

}

# 加载luarocks

function init_luarocks() {

}

# 启动apisix

function start() {

}

init

init_luarocks

start

脚本内容很简单，在启动apisix之前加载$INIT_DIR目录下的shell脚本及构建$LUAROCKS_DIR目录下的luarocks依赖。

为了方便开发，我在$INIT_DIR目录下放了安装lua和luarocks的脚本。就是简单的wget/tar/make。脚本内容就不贴代码了，可以在git上面看。

这样一个简单的apisix镜像就构建好了，因为apisix依赖etcd。所以这里采用docker-compose容器编排

version: '3.1'

services:

  apisix:

    #build:

    #  context: ./docker

    #  dockerfile: Dockerfile

    image: xshower/apisix:centos8

    restart: always

    depends_on:

      - etcd

    ports:

      - 9080:9080

      - 9443:9443

      - 9180:9180

    volumes:

      - ./docker/prepare-init.d:/prepare-init.d

      - ./conf/config.yaml:/usr/local/apisix/conf/config.yaml:ro

      - ./third:/usr/local/apisix/third

      - ./logs:/usr/local/apisix/logs

      - ./docker/entrypoint.sh:/entrypoint.sh

  etcd:

    image: bitnami/etcd:3.4.9

    user: root

    restart: always

    volumes:

      - ./etcd_data:/etcd_data

    environment:

      ETCD_DATA_DIR: /etcd_data

      ETCD_ENABLE_V2: "true"

      ALLOW_NONE_AUTHENTICATION: "yes"

      ETCD_ADVERTISE_CLIENT_URLS: "http://0.0.0.0:2379"

      ETCD_LISTEN_CLIENT_URLS: "http://0.0.0.0:2379"

    ports:

      - "2379:2379/tcp"

指定了apisix依赖以及文件路径映射和端口映射。这样，一个简单的apisix开发环境就搭建好了。

插件开发

接下来说apisix插件化开发。

apisix本身自带了甚多插件。limit-req限流；proxy-rewrite地址匹配；jwt-auth授权认证；kafka-logger日志等。

但是，有时候apisix自带插件不满足我们应用需求时，这时候就只能我们自己开发。

apisix默认读取的插件目录是$APISIX_HOME/apisix/plugins，apisix自带那些插件也都在这个目录底下。

当然也可以添加自定义的插件目录，需要修改/usr/bin/apisix

# 第二行内容修改前

package.path = "/usr/local/apisix/?.lua;" .. package.path

#修改后

package.path = "/usr/local/apisix/?.lua;/usr/local/apisix/third/?.lua;/usr/local/apisix/third/deps/share/lua/5.1/?.lua;" .. package.path

其中，/usr/local/apisix/third就是我们自定义的插件目录，这样apisix既会读取默认的插件目录，又会读取我们定义的插件目录。

目录定义好以后，记得把自定义的插件放在third/plugins目录下,不能直接放在third目录中。

接下来，我们写一个lua插件，内容很简单，每次请求的时候。打印日志。

local core = require("apisix.core")

local plugin_name = "third-plugin"

local schema = {

    type = "object",

    properties = {

        content = {

            type = "string"

        }

    }

}

local _M = {

    version = 0.2,

    priority = 5000,

    name = plugin_name,

    schema = schema,

}

function _M.access(conf, ctx)

    // 打印日志

    core.log.warn(conf.content)

end

return _M

然后修改$APISIX_HOME/conf/config.yaml

# allow_admin:                  
  # - 127.0.0.0/24              关闭dashboard仅127访问
    #   - "::/64"
port_admin: 9180              # 指定dashboard web端口

etcd:

  host:

    - "http://主机IP:2379"     # 修改成主机的ip,不能直接用127.0.0.1

plugins:

  - ...省略自带插件

  - third-plugin

启动docker。这里我用了idea自带的docker-compose插件。大家也可以再docker-compose.yml所在目录下执行docker-compose up -d命令