在Ubuntu上安裝Swagger,你可以選擇使用Docker或者直接下載并安裝Swagger的命令行工具。以下是兩種方法的詳細步驟:
安裝Docker: 如果你還沒有安裝Docker,請先安裝它。你可以使用以下命令來安裝Docker:
sudo apt update
sudo apt install docker.io
安裝完成后,啟動Docker服務并設置開機自啟:
sudo systemctl start docker
sudo systemctl enable docker
拉取Swagger UI鏡像: 使用以下命令從Docker Hub拉取Swagger UI的鏡像:
docker pull swaggerapi/swagger-ui
運行Swagger UI容器: 使用以下命令運行Swagger UI容器,并將本地的Swagger JSON文件掛載到容器中:
docker run -p 80:8080 -v /path/to/swagger.json:/usr/src/app/swagger.json swaggerapi/swagger-ui
其中,/path/to/swagger.json
是你本地的Swagger JSON文件的路徑。
下載Swagger命令行工具: 訪問Swagger的GitHub頁面(https://github.com/swagger-api/swagger-ui),找到最新版本的Swagger命令行工具(swagger-cli),然后下載它。你可以使用以下命令來下載:
wget https://github.com/swagger-api/swagger-cli/releases/download/v2.0.24/swagger-cli.jar
請注意,上面的URL中的版本號可能會更新,你需要訪問GitHub頁面獲取最新的版本號。
賦予執行權限: 下載完成后,賦予下載的JAR文件執行權限:
chmod +x swagger-cli.jar
使用Swagger命令行工具: 現在你可以使用Swagger命令行工具來驗證和查看你的Swagger文檔了。例如,使用以下命令來驗證Swagger JSON文件:
java -jar swagger-cli.jar validate /path/to/swagger.json
其中,/path/to/swagger.json
是你本地的Swagger JSON文件的路徑。
以上就是在Ubuntu上安裝Swagger的兩種方法。你可以根據自己的需求選擇合適的方法。