Swagger-editor and Swagger-ui in Docker

除了可以在线编辑swaggerAPI文档,还可以通过容器在本地进行编辑,并且也提供了swagger-ui的容器可以根据你写的json文件生成UI页面,方便前端童鞋的使用。这个是目前最简单的方法!~

1)下载swagger-editor的容器

docker pull swaggerapi/swagger-editor 
docker run -d -p 81:8080 swaggerapi/swagger-editor 

81:8080 将容器的8080端口暴露给localhost的81端口,在浏览中输入:localhost:81,就可以在容器中编辑api文档

编辑后,在页面上上方点击 File -> Download JSON,将文件下载到本地(/Users/fanfan/Downloads)命名为swagger.json

2)下载swagger-ui的容器

docker pull swaggerapi/swagger-ui 
images

3)json文件挂在到容器中

docker run -p 80:8080 -e SWAGGER_JSON=/foo/swagger.json -v /Users/fanfan/Downloads:/foo swaggerapi/swagger-ui 

-e:执行容器中/foo/swagger.json
-v:将/Users/fanfan/Downloads中的swagger.json挂在到 /foo中执行
没有将swagger.json 在容器内修改的好处:在外部修改后容器可以直接运行,如果在容器内容修改需要在compile一次生成新的容器,这就复杂了哈

4)web验证
输入:localhost:80


images
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,080评论 19 139
  • 前言 Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。...
    Raye阅读 4,683评论 1 7
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,985评论 6 342
  • "Swagger is the world’s largest framework of API develope...
    cry_hz阅读 12,272评论 0 4
  • • 郭小姐是个孤独的人,具体孤独到什么程度没人知道,她总是一个人来来去去。郭小姐一直希望有个男朋友陪着她,尽管她曾...
    congan阅读 300评论 0 1