Debian上Swagger的部署挑戰

在Debian上部署Swagger UI可以通過多種方式實現，以下是使用Docker和Nginx兩種常見方法的步驟：

使用Docker部署Swagger UI

1. 安裝Docker：

   如果你還沒有安裝Docker，請先安裝它?？梢允褂靡韵旅睿?/p>

   sudo apt update
   sudo apt install docker.io
   

2. 拉取Swagger UI鏡像：

   使用Docker Hub上的Swagger UI鏡像：

   docker pull swaggerapi/swagger-ui
   

3. 運行Swagger UI容器：

   運行一個容器并映射端口（例如8080）：

   docker run -p 8080:8080 -d swaggerapi/swagger-ui
   

4. 訪問Swagger UI：

   打開瀏覽器并訪問 http://your-debian-ip:8080，你應該能看到Swagger UI界面。

使用Nginx和Swagger UI靜態文件部署

1. 安裝Nginx：

   如果你還沒有安裝Nginx，請先安裝它：

   sudo apt update
   sudo apt install nginx
   

2. 下載Swagger UI靜態文件：

   你可以從Swagger UI的GitHub倉庫下載靜態文件，或者使用以下命令直接下載：

   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-bundle.js
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-standalone-preset.js
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui.css
   wget https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/swagger-ui-extensions.css
   

3. 創建一個目錄來存放Swagger UI文件：

   sudo mkdir -p /var/www/swagger-ui
   sudo cp swagger-ui-bundle.js swagger-ui-standalone-preset.js swagger-ui.css swagger-ui-extensions.css /var/www/swagger-ui/
   

4. 配置Nginx：

   編輯Nginx配置文件 /etc/nginx/sites-available/default，添加以下內容：

   server {
       listen 80;
       server_name your-debian-ip;
       location /swagger-ui/ {
           root /var/www/swagger-ui;
           try_files uri uri / /swagger-ui/index.html;
       }
   }
   

5. 重啟Nginx：

   sudo systemctl restart nginx
   

6. 訪問Swagger UI：

   打開瀏覽器并訪問 http://your-debian-ip/swagger-ui/，你應該能看到Swagger UI界面。

使用Swagger Codegen生成靜態文件

1. 安裝Swagger Codegen：

   你可以使用以下命令安裝Swagger Codegen：

   wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.21/swagger-codegen-cli-2.4.21.jar
   sudo mv swagger-codegen-cli-2.4.21.jar /usr/local/bin/swagger-codegen
   sudo chmod +x /usr/local/bin/swagger-codegen
   

2. 生成Swagger UI靜態文件：

   使用Swagger Codegen生成靜態文件：

   swagger-codegen generate -i path-to-your-swagger-spec -l static -o /var/www/swagger-ui
   

3. 配置Nginx：

   參考方法二中的Nginx配置步驟。

4. 重啟Nginx：

   sudo systemctl restart nginx
   

5. 訪問Swagger UI：

   打開瀏覽器并訪問 http://your-debian-ip/swagger-ui/，你應該能看到Swagger UI界面。

以上就是在Debian上部署Swagger UI的常見方法。