Ubuntu Swagger如何進行部署

在Ubuntu上部署Swagger可以通過以下幾種方法實現：

方法一：使用Swagger UI和Node.js

1. 安裝Node.js和npm：

• 訪問nodejs官網，下載適合Ubuntu的安裝包（例如node-v16.15.1-linux-x64.tar.xz）。
• 解壓安裝包并將bin目錄添加到系統的PATH環境變量中。

tar -xvf node-v16.15.1-linux-x64.tar.xz
export PATH=$PATH:/path/to/node-v16.15.1-linux-x64/bin

2. 安裝Express和其他必要的模塊：

npm install -g express body-parser cookie-parser multer

3. 創建并配置Express應用：

• 創建一個項目目錄并初始化package.json。
• 編輯index.js文件，設置Express應用以提供Swagger UI文件。

var express = require('express');
var app = express();
app.use('/swagger', express.static('public'));
app.listen(3000, function () {
  console.log("Swagger UI started at http://localhost:3000/swagger");
});

4. 下載并部署Swagger UI：

• 從GitHub克隆Swagger UI倉庫。
• 將dist目錄中的文件復制到Express應用的public目錄中。

5. 啟動Express應用：

node index.js

6. 訪問Swagger UI：

• 在瀏覽器中訪問http://localhost:3000/swagger。

方法二：使用Swagger Editor

1. 安裝Node.js和npm（與方法一相同）。

2. 安裝http-server：

npm install -g http-server

3. 下載并部署Swagger Editor：

• 從GitHub克隆Swagger Editor倉庫。
• 在Swagger Editor目錄下運行http-server。

cd swagger-editor
http-server -p 8080

4. 訪問Swagger Editor：

• 在瀏覽器中訪問http://localhost:8080。

方法三：使用Nginx

1. 安裝Nginx：

sudo apt-get install nginx

2. 下載Swagger Editor和Swagger UI：

• 從GitHub和GitHub分別下載Swagger Editor和Swagger UI的源碼。

3. 配置Nginx：

• 將Swagger Editor的index.html文件和Swagger UI的dist目錄復制到Nginx的默認HTML目錄（/usr/share/nginx/html）。
• 編輯Nginx配置文件（通常位于/etc/nginx/sites-available/default），確保正確配置了靜態文件路徑。

server {
    listen 80;
    server_name localhost;

    location /swagger-editor {
        root /usr/share/nginx/html;
    }

    location /swagger-ui {
        root /usr/share/nginx/html;
    }
}

4. 重啟Nginx：

sudo systemctl restart nginx

5. 訪問Swagger Editor和Swagger UI：

• 在瀏覽器中分別訪問http://localhost/swagger-editor和http://localhost/swagger-ui。