如何使用Docker在Mac上部署Swagger

如何使用Docker在Mac上部署Swagger

雖說Swagger有線上的Swagger Edit工具和Swagger Hub，但是由于網絡問題，使用起來根本不友善，倒不如在本地安裝一個swagger來得友善。

Docker 是一個開源的應用容器引擎，讓開發者可以打包他們的應用以及依賴包到一個可移植的容器中，然後釋出到任何流行的 Linux 機器上，也可以實作虛拟化。容器是完全使用沙箱機制，互相之間不會有任何接口。

下載下傳位址：https://download.docker.com/mac/stable/Docker.dmg

1.輕按兩下Docker.dmg打開安裝包，然後拖拽Moby藍鲸到應用檔案夾。在安裝過程中你将會被Docker.app請求輸入你電腦的系統密碼。給予進入特權的需要安裝網絡元件和連結到Docker應用程式。

2.輕按兩下Docker.app啟動Docker

3.藍鲸的頭狀态條表Docker正在運作，并且是可以從終端進入的。如果你已經安裝了這個app，你也會獲得暗示下一步成功的消息和連結到這個文檔，點選藍鲸圖示在狀态條上有下圖這樣一個顯示和彈出。

以上完成Docker的安裝。如果你還是沒能安裝成功，可點選參見博文Mac平台上Docker安裝與使用。

Docker常用指令

Swagger是一個規範和完整的架構，用于生成、描述、調用和可視化 RESTful 風格的 Web 服務。總體目标是使用戶端和檔案系統作為伺服器以同樣的速度來更新。檔案的方法，參數和模型緊密內建到伺服器端的代碼，允許API來始終保持同步。官網：http://swagger.io

Swagger Editer是用于編寫Swagger腳本文檔的編輯工具，可同步顯示文檔，基于js開發的Web應用。Github的位址：https://github.com/swagger-api/swagger-editor

執行如下指令後，即可完成安裝：

指令執行完畢後，在浏覽器中直接輸入<code>http://localhost</code>即可打開Swagger Editer,出現如下界面即證明安裝成功。

Swagger UI是用于展示編寫的swagger api 文檔的頁面。Github的位址：https://github.com/swagger-api/swagger-ui

和安裝Swagger Editer一樣，執行如下指令後，即可完成安裝：

指令執行完畢後，在浏覽器中直接輸入<code>http://localhost:8081</code>即可打開Swagger UI,出現如下界面即證明安裝成功。

以上即完成swagger的安裝，接下來就是在Swagger Edit中愉快地寫api啦！