Centos 部署YApi

一，什么是Yapi

   YApi 是一款开源项目，是高效、易用、功能强大的 api 管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务。

   官网：https://hellosean1025.github.io/yapi/，YApi具有以下功能特性：

• 权限管理
  扁平化权限设计，即保证了大型企业级项目的管理，又保证了易用性

• 可视化接口管理
  基于 websocket 的多人协作接口编辑功能和类 postman 测试工具，让多人协作成倍提升开发效率

• Mock Server
  易用的 Mock Server，MockServer 除支持普通的随机 mock 外，还增加了 Mock 期望功能，根据设置的请求过滤规则，返回期望数据

• 自动化测试（这个我比较关注）
  完善的接口自动化测试，保证数据的正确性，支持对 Response 断言

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

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

 

二，使用Docker创建Yapi容器

   1、拉取YApi镜像

docker pull silsuer/yapi

2、创建并启动容器

docker run --name yapi -dit -p 27017:27017 -p 9090:9090 -p 3000:3000 silsuer/yapi bash

27017是mogodb的端口，9090是YApi服务端端口，3000是UI客户端端口

查看是否创建成功 docker ps

三，容器中部署安装Yapi

1、进入容器 docker exec -it yapi bin/bash
2、在容器中启动mogondb服务

root@3d3a94296f11:/# service mongodb start
 * Starting database mongodb                                           [ OK ] 

　　3、因为Yapi需要git支持，先升级git源（我们学乖点，因为如果不先安装git直接部署Yapi会出现错误）

root@3d3a94296f11:/# apt-get update
Ign:1 http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 InRelease
Get:2 http://security.ubuntu.com/ubuntu xenial-security InRelease [107 kB]
Get:3 http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 Release [3457 B]
...

4、安装git，中途需要输入y同意安装

root@3d3a94296f11:/# apt-get install git
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following packages were automatically installed and are no longer required:
...

5，启动Yapi服务进行部署配置，有如下bash提示

root@3d3a94296f11:/# yapi server
在浏览器打开 http://0.0.0.0:9090 访问。非本地服务器，请将 0.0.0.0 替换成指定的域名或ip 
/bin/sh: 1: xdg-open: not found                        ------------（这个百度了很多也不清楚原因，放它一马）

6、使用本地浏览器打开：http://0.0.0.0:9090出现以下错误

 

 PS：到这里正常来讲浏览器访问会出现配置Yapi的界面，但是由于之前的官网yapi.demo.qunar.com已经不再维护，导致访问页面就会出现以上错误

7、解决方案

所以这里我们在容器中采用其他方式来安装Yapi：

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

安装完之后再启动YApi服务

yapi server

这时候再访问http://0.0.0.0:9090就会出现YApi的配置页面

 

 8、部署完成后查看命令窗口显示如下：

 

 9、根据上面提示进行操作

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

启动成功之后显示如下界面：

 

 注意：这样启动服务是在前台运行的，先ctrl+c结束掉服务，执行

nohup node /my-yapi/vendors/server/app.js 2>&1 & 

使服务在后台运行.

10、退出容器

exit

至此，部署完毕。