【记录】CentOs7 部署Yapi接口管理工具

引用连接：Linux环境部署YApi - 简书 (jianshu.com)

前言

Yapi是去哪儿网开源的一款接口管理工具。接口的文档的管理是一件比较痛苦的事情，后端开发不得不使用很长的时间去维护繁杂冗余的文档，而前端开发也因为文档的不精确也浪费开发时间。
工作中接口返回的参数值包含很多的异常场景，前端不得不写一大串的判断逻辑。配合前段调试需要模拟很多场景，比较费时费力，而且很多场景到了项目后期才能调试，在提交测试时时间就会显得很紧张。
总结起来文档式的接口管理方式浪费心里和时间，Aapi这款工具的旨意将接口作为一个公共的可视化的方式打通前段、后台、测试环节，整合在一块，共同使用维护，降低接口的维护成本。
这款工具免费开源，部署简单，还具有官方文档。

环境准备

  • 操作系统：centos 8
  • 环境要求：
    • nodejs>7.6
    • mongodb>2.6
    • git

 

安装nodejs

  1. 获取资源（部署nodejs尽可能选择偶数版本，因为偶数版本官方有较长的维护时间，故这次选择8.x。）
sudo curl -sL https://rpm.nodesource.com/setup_8.x | bash -

 

  1. 安装
sudo yum install -y nodejs

 

 

 

  1. 查看版本
sudo node -v

 

  1. 查看npm版本
sudo npm -v

 

 

安装mongodb

  1. 更新yum源（非必须）
sudo yum -y update
  1. 添加mongodb源文件，在/etc/yum.repos.d 创建一个 mongodb-org.repo 文件
touch /etc/yum.repos.d/mongodb-org.repo
  1. 编辑mongodb-org.repo文件
vim /etc/yum.repos.d/mongodb-org.repo
  1. 添加文件内容

[mongodb-org]
name=MongoDB Repository
baseurl=http://mirrors.aliyun.com/mongodb/yum/redhat/7Server/mongodb-org/3.2/x86_64/
gpgcheck=0
enabled=1

  1. 安装mongodb
yum install -y mongodb-org
  1. 启动mongodb
service mongod start
  1. 设置开机启动
chkconfig mongod on
  1. 打开moMongoDB(可忽略)
/bin/mongo
  1. 配置远程访问
vim /etc/mongod.conf
  • 注释 bindIp: 127.0.0.1
    #bindIp: 127.0.0.1
  1. 重启mongod
service mongod restart
 
image.png

安装git

  1. 安装git
sudo yum -y install git

 

部署YApi环境

  1. 准备环境搭建完成后，开始搭建YApi，安装命令，此处安装使用可视化部署[推荐]

执行 yapi server 启动可视化部署程序，输入相应的配置和点击开始部署，就能完成整个网站的部署。部署完成之后，可按照提示信息，执行 node/{网站路径/server/app.js} 启动服务器。在浏览器打开指定url, 点击登录输入您刚才设置的管理员邮箱，默认密码(ymfe.org) 登录系统（默认密码可在个人中心修改）。

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

 

  • 安装后的目录结构如下：
     
    image.png
  1. 启动YApi
sudo yapi server
  • 实例截图：
 
image.png
  1. 执行 yapi server 启动可视化部署程序，浏览器打开提示窗口上的地址，非本地服务器，将0.0.0.0替换指定的域名或IP，进入部署页面。
  • 实例截图
 
image.png
  1. 根据项目实际需要可以修改部署信息，点击【开始部署】，完成部署任务
  • 部署成功截图
 
image.png

 
image.png

4.根据部署日志截图上的提示信息，启动服务

sudo cd my-yapi/  #我的是root/my-yapi，看部署的时候各位的设置
sudo node vendors/server/app.js

启动服务：node vendors/server/app.js

 
image.png

 

浏览器打开部署日志上的访问地址http://127.0.0.1:3000就可以访问搭建的YApi工具了（非本地服务器，将127.0.0.1替换指定的域名或IP），此时YApi环境搭建完成


 
image.png

服务器管理

由于服务一停止，网站就挂了。所以可以用pm2永久守护这个yapi进程。
推荐使用 pm2 管理 node 服务器启动，停止

  1. 安装
npm install -g pm2
  1. 切换到yapi的vendors目录
cd my-yapi/vendors
  1. 执行
pm2 start server/app.js --watch
 
image.png

官方部署教程
Github源码
使用教程官方文档



作者：_52Hertz
链接：https://www.jianshu.com/p/f9e519c0cd5d
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

posted @ 2022-01-17 23:38  心即理-致良知-事上炼  阅读(98)  评论(0)  编辑  收藏  举报