1. 程式人生 > >swagger安裝部署流程

swagger安裝部署流程

在網上搜索很多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進入aaa目錄執行 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進入aaa\dist, 執行npm install -g http-server;

10.執行 http-server。