如何使用Docker在Mac上部署Swagger

灰太狼 2022-05-20 07:39 314阅读 0赞

# 如何使用Docker在Mac上部署Swagger #

> 虽说Swagger有在线的[Swagger Edit][]工具和[Swagger Hub][]，但是由于网络问题，使用起来根本不方便，倒不如在本地安装一个swagger来得方便。

## 安装Docker ##

> Docker 是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的容器中，然后发布到任何流行的 Linux 机器上，也可以实现虚拟化。容器是完全使用沙箱机制，相互之间不会有任何接口。

### 点击下载安装包 ###

下载地址：[https://download.docker.com/mac/stable/Docker.dmg][https_download.docker.com_mac_stable_Docker.dmg]

### 安装并运行Docker ###

*  1.双击Docker.dmg打开安装包，然后拖拽Moby蓝鲸到应用文件夹。在安装过程中你将会被Docker.app请求输入你电脑的系统密码。给予进入特权的需要安装网络组件和链接到Docker应用程序。
 *  2.双击Docker.app启动Docker
 *  3.蓝鲸的头状态条表Docker正在运行，并且是可以从终端进入的。如果你已经安装了这个app，你也会获得暗示下一步成功的消息和链接到这个文档，点击蓝鲸图标在状态条上有下图这样一个显示和弹出。  
    ![这里写图片描述][70]  
    以上完成Docker的安装。如果你还是没能安装成功，可点击参见博文[Mac平台上Docker安装与使用][Mac_Docker]。

[Docker常用命令][Docker]

--------------------

## 安装Swagger ##

> Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。官网：[http://swagger.io][http_swagger.io]

### 安装Swagger Editer ###

> Swagger Editer是用于编写Swagger脚本文档的编辑工具，可同步显示文档，基于js开发的Web应用。Github的地址：[https://github.com/swagger-api/swagger-editor][https_github.com_swagger-api_swagger-editor]

执行如下命令后，即可完成安装：

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

命令执行完毕后，在浏览器中直接输入`http://localhost`即可打开Swagger Editer,出现如下界面即证明安装成功。  
![这里写图片描述][70 1]

### 安装Swagger UI ###

> Swagger UI是用于展示编写的swagger api 文档的页面。Github的地址：[https://github.com/swagger-api/swagger-ui][https_github.com_swagger-api_swagger-ui]

和安装Swagger Editer一样，执行如下命令后，即可完成安装：

docker pull swaggerapi/swagger-ui
    docker run -d -p 80:8081 swaggerapi/swagger-ui

命令执行完毕后，在浏览器中直接输入`http://localhost:8081`即可打开Swagger UI,出现如下界面即证明安装成功。  
![这里写图片描述][70 2]

以上即完成swagger的安装，接下来就是在Swagger Edit中愉快地写api啦！

[Swagger Edit]: http://editor.swagger.io/
[Swagger Hub]: https://app.swaggerhub.com/
[https_download.docker.com_mac_stable_Docker.dmg]: https://download.docker.com/mac/stable/Docker.dmg
[70]: /images/20220520/e98949f24b9b44078af1eaf137f8ea73.png
[Mac_Docker]: https://blog.csdn.net/jiang_xinxing/article/details/58025417
[Docker]: http://www.runoob.com/docker/docker-command-manual.html
[http_swagger.io]: http://swagger.io
[https_github.com_swagger-api_swagger-editor]: https://github.com/swagger-api/swagger-editor
[70 1]: /images/20220520/5f6420c782af43d1b91fbb01fa766f60.png
[https_github.com_swagger-api_swagger-ui]: https://github.com/swagger-api/swagger-ui
[70 2]: /images/20220520/603a2cc5746c4e289b2dc65de3278d4c.png