apisix3.9.1 和 dashboard 离线安装

服务器配置

centos7 linux x86 64

前置

需要将离线安装包上传到服务器上 {上传目录 /root/apisix-soft/ }
【建议:优先上传etcd-*.jar \ apisix-*.rpm \ cyrus-*.rpm \ openldap-*.rpm 等安装好apisix后再上传apisix-dashboard-*.rpm】
可以自行网上寻找，或找一台可联网的服务器进行下载，也可以直接使用我的资源apisix离线安装包及依赖

必做

# 大部分需要更改 ulimit 
# 查看为1024则需要更改
ulimit -n
# 编辑并添加
vi /etc/profile
ulimit -SHn 65536

source /etc/profile
ulimit -n
# 65536

# 首先需要安装etcd
# 解压
tar -xvf etcd-v3.5.8-linux-amd64.tar.gz  && ll

# 移动到安装目录下 【我这里的app】
mv etcd-v3.5.8-linux-amd64  /app/etcd && cd /app/etcd
# 复制 etcd、etcdtl 到 bin下
cp -a etcd etcdctl /usr/bin/

# 创建目录
mkdir /etc/etcd/data
# 创建etcd配置文件
touch etcd.conf
# 加入
ETCD_NAME=etcd
ETCD_DATA_DIR=/etc/etcd/data

ETCD_LISTEN_CLIENT_URLS=http://0.0.0.0:2379
ETCD_LISTEN_PEER_URLS=http://0.0.0.0:2380

ETCD_ADVERTISE_CLIENT_URLS=http://0.0.0.0:2379
ETCD_INITIAL_ADVERTISE_PEER_URLS=http://0.0.0.0:2380
ETCD_INITIAL_CLUSTER_STATE=new
ETCD_INITIAL_CLUSTER_TOKEN=etcd-cluster

# 编写服务文件
cd /usr/lib/systemd/system
touch etcd.service

# 加入
[Unit]
Description=etcd key-value store
Documentation=https://github.com/etcd-io/etcd
After=network.target

[Service]
EnvironmentFile=/etc/etcd/etcd.conf
ExecStart=/usr/bin/etcd
Restart=always

[Install]
WantedBy=multi-user.target

# 启动etcd
systemctl start etcd
# 加入开机自启
systemctl enable etcd

安装apisix

# 执行命令等待安装完成 安装完成apisix会安装到 /usr/local/apisix/
rpm -Uvh /root/apisix-soft/*.rpm --nodeps --force
# 执行初始化  如果这里报错etcd  需要检查网络端口是否开放以及防火墙相关设置保证apisix可以连接到etcd
apisix init

# 处理完毕后修改配置文件  截图中的红框是需要增加或修改的地方 端口自行指定
apisix:
  node_listen: 8000
deployment:
  role: traditional
  role_traditional:
    config_provider: etcd
  etcd:
    host:
      - http://127.0.0.1:2379
  admin:
    admin_key:
      - name: admin
        key: edd1c9f034335f136f87ad84b625c8f1  # using fixed API token has security risk, please update it when you deploy to production environment
        role: admin

# 执行启动
apisix start

# 到这里apisix就安装完毕了也可以用系统服务来启动
systemctl start apisix
systemctl enable apisix  # 开机自启
systemctl status apisix # 如图

安装apisix-dashboard

# 安装
yum install /root/apisix-soft/apisix-dashboard-2.9.0-0.el7.x86_64.rpm

# 安装成功完毕后 会在apisix安装目录下生成dashboard目录

# 同样也需要更改配置文件
cd dashboard/conf/  && ll
vi conf.yaml
# 如图标红框的都是需要修改的地方

# 启动
nohup manager-api >/usr/local/apisix/dashboard/logs/manager.log 2>&1 &

# 我这里没将该加到软件服务中去 大家可以自行去官网查阅进行添加 当然不加也行

我这里提供官网的加入到软件服务操作，翻到底即可查阅apisix加入软件服务

坑

启动apisix查看日志发现pid相关报错

报这个错有俩个情况，一是关闭apisix不是通过apisix stop 或者 systemctl stop apisix来关闭导致存在一些存活的相关进程影响导致；二是本机有启动着的nginx导致；这俩者都是需要将相关的进程全部关闭

启动manager-api报错pid相关错误

这个貌似是一个bug，在apisix的Github也有相关的回复，暂时没有什么好的解决办法，只能删除/tmp/manager-api.pid，然后再启动

APISIX Dashboard面板访问报错Network Err

先确定apisix与etcd是否都启动着，如果都启动着，建议把etcd的数据备份，然后清空etcd，接着清空浏览器缓存，再访问，这个在apisix的Github上也有记录，偶现错误