swagger安装部署流程

Posted 2021-01-28 chenlb

在网上搜索很多swagger安装流程资料，最后总结一下。 需要下载 node.js、swagger-editor、swagger-ui，可以搜索下载。

a 安装node.js

1.下载并且安装node.js

b. 安装swagger-editor
1. 下载项目https://github.com/swagger-api/swagger-editor 并且解压。
2. npm install -g http-server

3. 进入swagger-editor文件夹。运行http-server命令。

4. 进入http://127.0.0.1 就可以看到swagger页面了。
5. 此软件可以做编辑修改swagger.json，文件，可存为本地文件。
c. 安装swagger-ui
1.下载swagger-ui-3.18.3
2.随便建个文件夹，比如 aaa，把它初始化为node方式：

通过cmd进入aaa目录里，然后执行 npm init，让输入name之类的地方都可以直接回车。完成之后aaa里会多出一个package.json 的文件。

3.将swagger-ui目录下的dist文件夹拷到aaa文件夹中。

4.安装express，使用node进入ａａａ目录执行 npm install express，看到安装完成，aaa文件夹里面多node_modules目录并有一些文件，有3.7M。

5.在aaa文件夹中创建 index.js 文件。

6.测试。执行：node index.js

7.dist中的index.html中，看到了 url: "http://petstore.swagger.io/v2/swagger.json", 改成swagger.json

8.将准备好的 swagger.json 文件复制到 dist目录下。

9.使用node进入ａａａdist, 运行npm install -g http-server；

10.运行 http-server。