在Linux環境下部署Swagger主要有兩種方式:使用Docker容器和手動安裝。以下是詳細的步驟:
安裝Docker: 如果你還沒有安裝Docker,請先安裝它??梢詤⒖?a >Docker官方文檔進行安裝。
拉取Swagger Editor和Swagger UI鏡像:
docker pull swaggerapi/swagger-editor:v4.6.0
docker pull swaggerapi/swagger-ui:v4.15.5
運行Swagger Editor容器:
docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
這將把Swagger Editor容器運行在宿主機的38080端口上。
運行Swagger UI容器:
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
這將把Swagger UI容器運行在宿主機的38081端口上。
訪問Swagger Editor和Swagger UI:
安裝Node.js和npm:
wget https://nodejs.org/dist/v14.17.0/node-v14.17.0-linux-x64.tar.xz
tar -xvf node-v14.17.0-linux-x64.tar.xz
cd node-v14.17.0-linux-x64
sudo ln -s /node-v14.17.0-linux-x64/bin/node /usr/local/bin/node
sudo ln -s /node-v14.17.0-linux-x64/bin/npm /usr/local/bin/npm
安裝Express和其他必要的模塊:
npm install express body-parser cookie-parser multer
下載并解壓Swagger UI:
git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install
配置和啟動Swagger UI:
index.js
文件:var express = require('express');
var app = express();
app.use('/swagger', express.static('dist'));
app.get('/', function (req, res) {
res.send('Hello World');
});
app.listen(3000, function () {
var host = server.address().address;
var port = server.address().port;
console.log("應用實例,訪問地址為 http://%s:%s", host, port);
});
node index.js
訪問Swagger UI:
打開瀏覽器,訪問http://your_server_ip:3000/swagger
,即可看到Swagger UI界面。
希望這些步驟能幫助你在Linux環境下成功部署Swagger。如果有任何問題,請參考相關的官方文檔或尋求社區幫助。