搭建Yapi接口文档服务

搭建Yapi接口文档服务

标签（空格分隔）： linux

官方文档

https://hellosean1025.github.io/yapi/devops/index.html

系统环境配置

# 关闭firewalld防火墙并禁止开机自启动
systemctl disable firewalld && systemctl stop firewalld

# 临时和永久关闭SElinux
setenforce 0 

sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

# 清空iptables规则
iptables -X && iptables -F && iptables -Z    

安装Node、Npm

# 下载并解压文件
cd /opt

wget https://nodejs.org/dist/v9.8.0/node-v9.8.0-linux-x64.tar.xz

xz -d node-v9.8.0-linux-x64.tar.xz

tar -xf node-v9.8.0-linux-x64.tar


# 创建链接文件
cd node-v9.8.0-linux-x64

ln -s /opt/node-v9.8.0-linux-x64/bin/node /usr/local/bin/node

ln -s /opt/node-v9.8.0-linux-x64/bin/npm /usr/local/bin/npm


# 查看版本并切换镜像源
node -v

npm -v

npm config set registry https://registry.npm.taobao.org

安装Mongodb

# 下载包
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel70-4.4.2.tgz
tar zxvf mongodb-linux-x86_64-rhel70-4.4.2.tgz -C /usr/local/

mv /usr/local/mongodb-linux-x86_64-rhel70-4.4.2 /usr/local/mongodb

rm -rf mongodb-linux-x86_64-rhel70-4.4.2.tgz


cd /usr/local/mongodb/

mkdir logs data conf

cd logs/

touch mongodb.logs

cd ../conf/

vim mongodb.conf

systemLog:  
quiet: false  
path: /usr/local/mongodb/logs/mongodb.logs 
logAppend: false  
destination: file  
processManagement:  
fork: true  
pidFilePath: /usr/local/mongodb/bin/mongodb.pid  
net:  
bindIp: 0.0.0.0  
port: 27017  
maxIncomingConnections: 65536  
wireObjectCheck: true     
storage:  
dbPath: /usr/local/mongodb/data  
journal:  
    enabled: true         
operationProfiling:  
slowOpThresholdMs: 100  
mode: off 


# mongod 开启自启
vim /etc/systemd/system/mongodb.service

[Unit]  
Description=mongodb  
After=network.target remote-fs.target nss-lookup.target  
  
[Service]  
Type=forking  
RuntimeDirectory=mongodb
RuntimeDirectoryMode=0751
PIDFile=/usr/local/mongodb/bin/mongodb.pid
ExecStart=/usr/local/mongodb/bin/mongod --config /usr/local/mongodb/conf/mongodb.conf  
ExecStop=/usr/local/mongodb/bin/mongod --shutdown --config /usr/local/mongodb/conf/mongodb.conf  
PrivateTmp=false  
  
[Install]  
WantedBy=multi-user.target


systemctl start mongodb.service
systemctl enable mongodb.service


# 查看端口
ss -tunl | grep 27017

安装Git

yum install git -y

可视化部署Yapi

npm install -g yapi-cli --registry https://registry.npm.taobao.org

/opt/node-v9.8.0-linux-x64/bin/yapi server

根据命令行提示信息，在浏览器中访问部署页面

部署过程中遇到的坑

#如果出现以下错误，请安装如下模块文件并刷新页面重新部署

Error: Cannot find module 'fs-extra'
npm install --save fs-extra

#如果出现如下错误，请安装如下模块文件并刷新页面重新部署

Error: Cannot find module 'nodemailer'
npm install nodemailer --save

#如果出现如下错误，请修改添加以下路径下的db.js文件内容并刷新页面重新部署

Error: (node:687) DeprecationWarning: current Server Discovery and Monitoring engine is deprecated, and will be removed in a future version. To use the new Server Discover and Monitoring engine, pass option { useUnifiedTopology: true } to the MongoClient constructor
cd /etc/my-yapi/vendors/server/utils
在db.js文件的第19行处下面添加如下内容

mongoose.set('useUnifiedTopology', true);

# 如果出现如下错误，请根据提示删除init.py文件

node server/install.js

Error: init.lock文件已存在，请确认您是否已安装。如果需要重新安装，请删掉init.lock文件
进入/etc/my-yapi/目录

rm init.lock -y

# 如果重新安装，出现如下错误，请删除管理员账号信息

cd /etc/my-yapi/vendors

node server/install.js

(node:20024) UnhandledPromiseRejectionWarning: Error: 初始化管理员账号 "admin@admin.com" 失败, E11000 duplicate key error collection: yapi.user index: email_1 dup key: { : "admin@admin.com" }
# 进入数据库删除管理员账户信息

mongo

> use yapi;

> db.user.remove({"username":"admin"});

node server/install.js

启动服务

cd /etc/my-yapi/vendors
node server/app.js