yapi安装及使用

yapi介绍

YApi是一款高效、易用、功能非常强大的 api 可视化接口管理平台,旨在为互联网公司的技术人员提供更优雅的接口管理服务系统。它可以帮助开发者快速创建、发布、维护 API接口,并且YApi为用户提供了优秀的交互体验,技术人员只需利用平台提供的接口数据写入工具以及很少的点击操作就可以实现接口的管理。

yapi功能介绍

技术架构:nodeJS+mongodb

具体功能如下:

  • 项目管理:提供基本的项目分组、项目基本信息管理、项目接口管理
  • 接口管理:基于websocket的多人协作接口编辑功能和功能类似于postman测试工具,多人协作的效率非常高
  • Mock服务:集成目前最流行的Mock服务,接口测试非常方便
  • 扁平化管理:引入了产品管理权限的概念,不同角色做不同的事情。
    • 超级管理员:创建分组、分配组长、管理所有成员
    • 组长:创建项目、管理项目、分组信息、管理小组成员开发者
    • 开发者:只有接口相应的管理权限
  • 自动化测试:
    • 完善的接口自动化测试,保证数据的正确性,支持对 Response 断言

针对互联网开发公司,一般开发人员规模几十个左右,每个人可能都会负责一部分接口开发的工作,一般公司都会有要求接口管理规范,这样对后续的运维非常重要。传统的方式采用word、excel等文档留存,或者使用swagger进行管理。这样的接口管理存在过于分散、文档也比较容易丢失、更新不及时等缺点。使用YApi可以很好的解决这些问题,后续的运维或者新人入职接手项目会更加的容易。

安装mongodb

docker pull mongo
docker run -d --name mongo -e MONGO_INITDB_ROOT_USERNAME=root -e MONGO_INITDB_ROOT_PASSWORD=szz123 -p 27017:27017 mongo

注意:确认服务器中防火墙对应的27017端口开放

安装yapi

docker pull jayfong/yapi:1.10.2

注意:不要使用 yapipro/yapi 这个镜像

docker run \
-d \
--name yapi \
--restart=always \
--privileged=true \
-p 3000:3000 \
-e YAPI_ADMIN_ACCOUNT=admin@qq.com \
-e YAPI_ADMIN_PASSWORD=123456 \
-e YAPI_CLOSE_REGISTER=true \
-e YAPI_DB_SERVERNAME=DB_IP \
-e YAPI_DB_PORT=27017 \
-e YAPI_DB_DATABASE=yapi \
-e YAPI_DB_USER=root \
-e YAPI_DB_PASS=szz123 \
-e YAPI_DB_AUTH_SOURCE=admin \
-e YAPI_MAIL_ENABLE=false \
jayfong/yapi:1.10.2

注意:确认服务器中防火墙对应的3000端口开放,DB_IP 替换为自己的服务器IP

登录yapi

image

登录地址 http://ip:3000 账户密码 admin@qq.com/123456

image

接下来我们就可以创建自己的项目接口文档了

参考

Docker实战:docker安装YApi接口管理工具

posted @ 2023-08-05 09:15  strongmore  阅读(389)  评论(0编辑  收藏  举报