APISIX系列 | 使用 docker-apisix 安装APISIX服务

官方仓库：https://github.com/iresty/docker-apisix

官方仓库

拉取

git clone git@github.com:iresty/docker-apisix.git

安装 etcd 服务

1、拉去etcd镜像

docker pull bitnami/etcd:3.3.13-r80

2、启动etcd服务器实例

docker run -it --name etcd-server \ -v /e/github/docker-apisix/example/etcd_conf/etcd.conf.yml:/opt/bitnami/etcd/conf/etcd.conf.yml \ -p 2379:2379 \ -p 2380:2380 \ --env ALLOW_NONE_AUTHENTICATION=yes \ -d bitnami/etcd:3.3.13-r80

 Windows 环境执行命令：

docker run -it --name etcd-server -v /e/github/docker-apisix/example/etcd_conf/etcd.conf.yml:/opt/bitnami/etcd/conf/etcd.conf.yml -p 2379:2379 -p 2380:2380 --env ALLOW_NONE_AUTHENTICATION=yes -d bitnami/etcd:3.3.13-r80

3、测试是否安装成功

进入etcd实例

docker exec -it etcd-server /bin/sh -c "[ -e /bin/bash ] && /bin/bash || /bin/sh" I have no name!@1d05cea9f08c:/opt/bitnami/etcd$

测试

$ etcdctl put key-test "Hi Tinywan!" // 设置 OK I have no name!@1d05cea9f08c:/$ etcdctl get key-test // 获取 key-test Hi Tinywan! I have no name!@1d05cea9f08c:/$ etcdctl del key-test // 删除 1 I have no name!@1d05cea9f08c:/$ etcdctl get key-test // 删除 I have no name!@1d05cea9f08c:/$

4、进入容器查看是否已经开启v2协议

> docker exec -it etcd-server bash $ etcd --help |grep enable-v2 usage: etcd [flags] start an etcd server etcd --version show the version of etcd etcd -h | --help show the help information about etcd etcd --config-file path to the server configuration file etcd gateway run the stateless pass-through etcd TCP connection forwarding proxy etcd grpc-proxy run the stateless etcd v3 gRPC L7 reverse proxy --enable-v2 'true' --experimental-enable-v2v3 ''

--enable-v2 'true' 表示已经开启v2协议。

原因：APISIX 目前仅支持 etcd 的 v2 协议存储，但最新版的 etcd (3.4 开始）已经默认关闭 v2 协议。 需要在启动参数中添加 --enable-v2=true，才能启用 v2 协议。　　

4、启动etcd客户端实例

$ docker run -it --rm \ --network app-tier \ --env ALLOW_NONE_AUTHENTICATION=yes \ bitnami/etcd:latest etcdctl --endpoints http://etcd-server:2379 set /message Hello

Windows 环境

docker run -it --rm --network app-tier --env ALLOW_NONE_AUTHENTICATION=yes bitnami/etcd:3.3.13-r80 etcdctl --endpoints http://etcd-server:2379 set /message Hello

安装 apisix 服务

使用官方镜像可能会超时，提示错误：request canceled (Client.Timeout exceeded while awaiting headers)

1、拉去镜像

docker pull registry.cn-beijing.aliyuncs.com/tinywan/apisix:alpine

2、修改配置文件

config.yaml

etcd: host: "http://127.0.0.1:2379" # etcd address

修改为本机电脑的内网IP，windows 查看本地内网IP。打开命令行，输入 ipconfig

 修改后

etcd: host: "http://192.168.1.3:2379" # etcd address　　

2、运行服务

> docker run --name tinywan-api-gateway \ -v /e/GitHub/docker-apisix/example/apisix_conf/config.yaml:/usr/local/apisix/conf/config.yaml \ -v /e/GitHub/docker-apisix/example/apisix_log:/usr/local/apisix/logs \ -p 8080:9080 \ -p 8083:9443 registry.cn-beijing.aliyuncs.com/tinywan/apisix:alpine

这里挂在配置文件和日志目录都是使用的绝对路径

windows 文件目录为

E:\GitHub\docker-apisix

 则挂在目录地址为

/e/GitHub/docker-apisix

3、查看服务是佛已经启动

> docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 7747e9a4bcd6 registry.cn-beijing.aliyuncs.com/tinywan/apisix:alpine "sh -c '/usr/bin/api…" 14 seconds ago Up 13 seconds 0.0.0.0:8080->9080/tcp, 0.0.0.0:8083->9443/tcp tinywan-api-gateway 1d05cea9f08c bitnami/etcd:3.3.13-r80 "/entrypoint.sh etcd" 29 minutes ago Up 29 minutes 0.0.0.0:2379-2380->2379-2380/tcp etcd-server

控制台

APISIX 内置了 dashboard，使用浏览器打开 http://127.0.0.1:8080/apisix/dashboard/ 即可使用， 不用填写用户名和密码，直接登录　　

 直接点击登录

 恭喜你安装成功