注:先启动mongodb、再启动yapi。
今天我们带着API接口管理的问题,一起来看看一款可视化接口管理平台YApi,让能轻松帮助我们搞定API的管理问题。
YApi介绍
在决定使用YApi后,首先会考虑如何部署。虽说官方提供了详细的部署文档,但一顿操作下来却踩了不少坑,却被难倒了门外。在此,结合官方提供的部署教程,自己基于docker-compose、Kubernetes等方式提供了一键离线安装YApi,更加的方便。
登录后进入首页,首页展示了分组与项目。
confijson:YApi配置文件,可按需修改打入到镜像。commons.js:解决YApibug问题。
想要使用YApi,首先要注册账号。
浏览器访问地址http://<部署环境IP>:3000,可用超级管理员登录或直接注册新账号。
特性
去哪儿携程艺龙美团百度腾讯阿里巴巴京东今日头条唯品支付链家网快手便利蜂中商惠民新浪VIPKID马蜂窝
docker镜像tar包获取
可直接参考官方教程。
可视化接口管理,基于Websocket的多人协作接口编辑功能和类Postman测试工具,让多人协作成倍提升开发效率。扁平化权限设计,即保证了大型企业级项目的管理,又保证了易用性。自动化测试,完善的接口自动化测试,保证数据的正确性,并支持对Response断言。MockServer,易用的MockServer,方便Mock数据的生成。除支持普通的随机Mock外,还增加了Mock期望功能,根据设置的请求过滤规则,返回期望数据。数据导入导出,支持导入Swagger,Postman,HAR数据格式,导出HTML,Markdown,JSON数据格式,方便API接口文档的迁移及归档。插件机制,强大的插件机制,满足各类业务需求,便于扩展对接等。基于JSON5和Mockjs定义接口返回数据的结构和文档,效率提升多倍。免费开源,支持二次开发,内网部署,信息安全可靠。
在开始使用YApi之前,我们先来熟悉一下YApi的网站结构,这将让你快速了解YApi。
登录与注册:
可直接参考官方教程,除了部署本身之外,通过该教程让我们进一步了解到YApi的一些细节问题,如:依赖什么、配置什么等,这也为我接下来Docker部署提供了参考。
首页头部展示了当前所在的位置、搜索框、新建项目、查看文档和用户信息。首页左侧展示分组信息,“分组”是“项目”的集合,只有超级管理员可以管理分组。首页右侧是分组下的项目和成员列表,点击左侧的某个分组,右侧会出现该分组下的项目和成员信息。点击项目右上角的星星即可关注项目,关注的项目可以在“我的关注”页面查看。
在能正常连接外网的docker环境下,拉取镜像xcbeyond/yapi。dockerpullxcbeyond/yapi:2生成docker镜像tar包。dockersave-oyapi-tarxcbeyond/yapi:2将镜像tar包yapi-tar上传将要部署的环境上。导入镜像tar包。dockerload 此时你作为新用户,没有任何分组与项目的权限,因此只能搜索、浏览“公开项目”的接口,如果在首页找不到任何项目,请联系管理员将你加入对应项目。 有外网时,可忽略该操作。 这部分主要讲述镜像的制作过程,docker镜像已推送至dockerhub,直接拉取,无需自己动手制作镜像。 在个人信息页面可以查看并修改自己的用户名、密码等信息。 谁在用 镜像制作 点击一个项目,进入项目页,项目页展示了属于该项目的全部接口,并提供项目、接口的全部操作。 将Kubernetes部署资源文件上传至部署环境上,分别通过命令kubectlapply-f执行文件mongodyaml和yapyaml完成部署即可。 Docker在线/离线部署 个人中心: YApi操作手册 在开始之前,可以先体验一把,体验地址:https://yapbaidu.com 在有网络的条件下,可直接通过可视化部署是非常简单的,但在内网下,却无能为力。特制作Docker镜像,可通过docker-compose或Kubernetes等方式一键部署YApi。 认识YApi 超级管理员:admin@admicom、ymforg,登录后建议修改密码。 YApi是高效、易用、功能强大的API管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护API,YApi还为用户提供了优秀的交互体验,开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。 项目页左侧的“接口列表”展示了该项目下的所有接口,右侧默认显示该项目下所有接口的列表。点击左侧的某个接口,右侧会出现“预览”、“编辑”和“运行”。点击左侧的“测试集合”使用测试集功能。点击二级导航的“设置”,项目组长即可编辑项目信息和管理成员列表。点击二级导航的“动态”,即可查看项目的操作日志。 部署 鼠标移动到右上角的用户头像或用户名上,即可点击“个人中心”查看个人信息。 项目页: 一键部署 如果在离线情况下,需事先准备好docker镜像tar包。 此时你作为新用户,只能浏览接口信息,不可以编辑项目或接口,如果需要编辑,请联系管理员将你加入该项目。 支持通过docker-compose和Kubernetes两种方式一键部署。 首页: 将docker-compose文件/yaip/docker-composyaml上传至部署环境上,执行docker-compose命令docker-composeup-d完成部署即可。 超级管理员:admin@admicom、ymforg,登录后建议修改密码。 官方部署教程 文章为作者独立观点,不代表观点