美文网首页Java
Yapi-API管理平台安装配置

Yapi-API管理平台安装配置

作者: 大周 | 来源:发表于2018-10-12 16:28 被阅读429次

    前言

    随着 Web 技术的发展,前后端分离构架变的越来越流行。前端负责数据的展现和交互,大大细化了开发者的职责,提高了开发效率,但与此同时也带来了一些问题:

    对于前端工程师,后端提供的接口文档大多是不规范的,有使用 wiki 的,有 word 文档的,甚至还有用即时聊天软件沟通的,后端接口对于前端就像一个黑盒子,经常遇到问题是接口因未知原因增加参数了,参数名变了,参数被删除了。对于后端工程师,接口对接时总是需要写冗杂繁琐的文档,需要大量时间去维护接口文档。

    ........

    还有很多问题就不一一列举了,只要做过前后端分离项目的开发人员,或者做过APP后台接口的开发人员,又或者做过微信小程序的开发人员都会懂的。今天不说太多空话,只是给大家分享一个api管理平台工具,也是我目前在用的一个工具。

    市面上关于api管理的工具/系统其实有很多很多,知乎上搜一下各种对比介绍都有,我当时就是这么过来的,咱今天也不争辩谁好谁坏。

    关于Yapi

    YApi是去哪儿移动架构组开源的API管理系统,是一款完全免费的api管理平台。

    官网地址:https://yapi.ymfe.org/

    示例地址:http://yapi.demo.qunar.com/

    使用教程:https://yapi.ymfe.org/documents/index.html

    系统界面也是很简洁的

    其主要特点如下:

    权限管理

    YApi 成熟的团队管理扁平化项目权限配置满足各类企业的需求

    可视化接口管理

    基于 websocket 的多人协作接口编辑功能和类 postman 测试工具,让多人协作成倍提升开发效率

    Mock Server

    易用的 Mock Server,再也不用担心 mock 数据的生成了

    自动化测试

    完善的接口自动化测试,保证数据的正确性

    数据导入

    支持导入 swagger, postman, har 数据格式,方便迁移旧项目

    插件机制

    强大的插件机制,满足各类业务需求

    安装Yapi

    Yapi有两种使用方式,一种是在线使用官方提供的系统,这种肯定不适用与大部分公司,另外一种是下载并安装到指定服务器,我们这里介绍下载安装到centos中。

    官方教程中有关于内网部署系统的文档说明,但是我在使用的过程中发现有一些坑,安装过程可能没有文档写的那么的简单。

    内网部署文档:

    https://yapi.ymfe.org/devops/index.html

    安装环境要求:

    nodejs(7.6+)yapi是用nodejs开发的,所以需要此环境编译运行

    mongodb(2.6+)用来存储系统的数据

    git为了在线下载yapi源码

    方式一. 可视化部署[推荐]

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

    方式二. 命令行部署

    *如果 github 压缩文件无法下载,或需要部署到一些特殊的服务器,可尝试此方法

    注:上述安装都会有个很大的问题,就是npm的使用,网络原因,npm在执行某些命令的时候经常卡死不动,这个时候需要采用淘宝提供的景象才可以。可以看这里https://npm.taobao.org/ 或者请教专业前端人员。

    安装后配置

    以上两种方法执行后,都只是完成了系统的初步安装,还需要打开浏览器页面,完成系统的配置才行。

    这里以第一种方式为例:

    第一个命令执行后:

    根据信息,需要切换到对应的目录才能执行yapi命令

    然后打开浏览器访问即可,记得关闭防火墙

    浏览器打开是个配置页面,填写基本信息:

    数据库认证那里,默认安装的mongodb是没有密码的,所以不需要认证,如果修改了密码,那就需要填写了

    填写后确定,就会弹出安装进度信息:

    后台系统也会实时打印日志信息:

    安装过程可能会慢一点,需要耐心等待了。如果以上方式失败了,尝试第二种,先把文件下载了然后安装。

    安装后就可以访问使用系统了:

    登录用户名就是配置的管理员邮箱,密码默认是 ymfe.org,登陆后可以自行修改。

    默认启动是前台启动,我们需要改为后台运行才可以。这里推荐使用pm2管理node服务器的启动、停止等。官网教程中有说明。如果你会npm,你会很在行的。

    登录之后的系统长这个样子:

    关于系统的使用,可以参考官网的教程,介绍的还是很详细的。或者等我改天再分享。

    补充

    以下补充的知识仅为本文的yapi服务,所以不做过多介绍,只说明基本操作。

    git安装

    一个命令:

    mongodb安装

    官网安装文档:https://docs.mongodb.com/v3.6/installation/

    1、 在/etc/yum.repos.d创建一个mongodb-org.repo源文件

    编辑此文件

    这段内容可以从mongodb官网复制,根据你所安装的版本选择

    保存退出

    2、 更新yum源

    3、 安装mongodb

    4、 启动mongod服务

    5、 设置为开机启动

    6、 配置远程访问,默认只能本机访问。如果不需要远程访问,这一步可以省略

    mongodb配置文件为/etc/mongod.conf:

    默认监听127.0.0.1,注释掉即可远程访问

    7、 如果需要修改认证,建议查阅相关文档,这里不再介绍

    nodejs安装

    官网下载所需要的nodejs,建议下载8.*,淘宝镜像下载地址:https://nodejs.org/dist/

    我这里下载的压缩包:

    解压即可:

    将解压后的文件目录配置到path中即可使用npm相关命令:

    测试命令是否可用:

    pm2安装

    一行命令搞定:

    常用命令:


    相关文章

      网友评论

        本文标题:Yapi-API管理平台安装配置

        本文链接:https://www.haomeiwen.com/subject/zdygaftx.html