告别swagger,加强版接口文档yapi工具安装

简介: 告别swagger,加强版接口文档yapi工具安装


一.安装git

yum -y install git
git --version

二.安装mongodb

三.安装node.js

可以参考楼主专栏 ,但是注意版本过高也会出现警告。

四.安装yapi

这里楼主使用的是下载后 执行安装(原因是可视化部署时报错较多)。

mkdir yapi
cd yapi
git clone https://github.com/YMFE/yapi.git vendors //或者下载 zip 包解压到 vendors 目录(clone 整个仓库大概 140+ M,可以通过 `git clone --depth=1 https://github.com/YMFE/yapi.git vendors` 命令减少,大概 10+ M)
cp vendors/config_example.json ./config.json //复制完成后请修改相关配置 可以参考以下配置
cd vendors
npm install --production --registry https://registry.npm.taobao.org
npm run install-server //安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置
node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候

image.png

修改config.json。

{
  "port": "3000", #运行端口号
  "adminAccount": "demo@demo.com", #账号名称
  "timeout":120000,
  #mongodb权限一定要配置正确 否则会报权限错误 
  "db": {
    "servername": "127.0.0.1",
    "DATABASE": "admin",
    "port": 27017,
    "user": "root",
    "pass": "123456",
    "authSource": ""
  },
  "mail": {
    "enable": true,
    "host": "smtp.163.com",
    "port": 465,
    "from": "***@163.com",
    "auth": {
      "user": "***@163.com",
      "pass": "*****"
    }
  }
}

安装成功后访问ip:3000,(上文配置文件的端口 请注意开启端口号)。出现页面则代表安装成功。

五.安装pm2

以上安装完成后 yapi不能后台启动 所以需要安装pm2。

npm install pm2 -g

出现以下提示则表示安装成功。

image.png

然后执行以下操作  /usr/local/node/node-v13.13.0-linux-x64/lib/node_modules/pm2/bin/pm2为红框位置,请根据自己的配置修改。

ln -s /usr/local/node/node-v13.13.0-linux-x64/lib/node_modules/pm2/bin/pm2 /usr/local/bin/

执行命令 app.js路径为安装位置的路径,请根据配置修改。

pm2 start "/usr/local/yapi/vendors/server/app.js" --name yapi

出现以下则代表成功。

image.png

错误一 以下问题 则是用户权限有问题 需要在mongodb下执行以下命令

image.png

db.updateUser(
 "root",
        {
            roles : 
            [
                  {"role" : "userAdminAnyDatabase","db" : "admin"},
                  {"role" : "dbOwner","db" : "admin"},
                  {"role" : "clusterAdmin", "db": "admin"}
             ]
        }
)      

错误二 文件夹权限不够

image.png

执行

chmod 777 /usr/local/yapi/vendors/node_modules


相关文章
|
8月前
|
Oracle 关系型数据库 Java
程序员必备推荐一款与Swagger媲美的数据库文档生成工具
程序员必备推荐一款与Swagger媲美的数据库文档生成工具
85 0
|
3月前
|
前端开发 Java API
Swagger接口文档 —— 手把手教学,全方位超详细小白能看懂,百分百能用Java版
本文提供了一份详细的Swagger接口文档生成工具的使用教程,包括了导入依赖、配置类设置、资源映射、拦截器配置、Swagger注解使用、生成接口文档、在线调试页面访问以及如何设置全局参数(如token),旨在帮助Java开发者快速上手Swagger。
828 0
Swagger接口文档 —— 手把手教学,全方位超详细小白能看懂,百分百能用Java版
|
6月前
|
JSON 缓存 Java
Spring Boot集成 Swagger2 展现在线接口文档
本节课详细分析了 Swagger 的优点,以及 Spring Boot 如何集成 Swagger2,包括配置,相关注解的讲解,涉及到了实体类和接口类,以及如何使用。最后通过页面测试,体验了 Swagger 的强大之处,基本上是每个项目组中必备的工具之一,所以要掌握该工具的使用,也不难。
|
7月前
|
前端开发 Java 程序员
Spring Boot (十五): 优雅的使用 API 文档工具 Swagger2
Spring Boot (十五): 优雅的使用 API 文档工具 Swagger2
支付系统---微信支付14----创建案例项目---介绍,第二步引入Swagger,接口文档和测试页面生成工具,定义统一结果的目的是让结果变得更加规范,以上就是谷粒项目的几个过程
支付系统---微信支付14----创建案例项目---介绍,第二步引入Swagger,接口文档和测试页面生成工具,定义统一结果的目的是让结果变得更加规范,以上就是谷粒项目的几个过程
|
8月前
|
前端开发 IDE Java
比Swagger更好用的工具
比Swagger更好用的工具
247 2
比Swagger更好用的工具
|
8月前
|
API
23_Swagger接口文档
23_Swagger接口文档
81 0
|
8月前
|
数据可视化 测试技术 API
Swagger--API表达工具
Swagger--API表达工具
81 2
|
8月前
|
前端开发 应用服务中间件 nginx
使用swagger和knife4j生成的接口文档在浏览器中输入地址后报404错误
使用swagger和knife4j生成的接口文档在浏览器中输入地址后报404错误
575 0
|
前端开发 数据可视化 Java
Swagger 接口文档 | knife4j 增强方案
Swagger 接口文档 | knife4j 增强方案
200 0
Swagger 接口文档 | knife4j 增强方案