在CentOS上配置Swagger的步驟如下:
首先,你需要在CentOS系統上安裝Node.js和npm??梢酝ㄟ^以下命令來完成安裝:
yum install gcc-c make -y
curl -sL https://rpm.nodesource.com/setup_12.x | bash -
yum install nodejs -y
驗證安裝是否成功:
node -v
npm -v
安裝Swagger-Editor
創建一個新的目錄來存放Swagger-Editor,并下載對應版本的Swagger-Editor源碼包:
mkdir /opt/swagger
cd /opt/swagger
wget https://github.com/swagger-api/swagger-editor/archive/v3.14.0.tar.gz
tar -xzf v3.14.0.tar.gz
cd swagger-editor-3.14.0
npm install -g http-server
啟動Swagger-Editor服務:
http-server -p 8080
訪問http://<your-server-ip>:8080
確認可以訪問。
安裝Swagger-UI
在Swagger目錄中,下載并解壓Swagger-UI的最新版:
cd /opt/swagger
wget https://github.com/swagger-api/swagger-ui/archive/v3.34.0.tar.gz
tar -xzf v3.34.0.tar.gz
cd swagger-ui-3.34.0
npm init -y
npm install express --save
mkdir public
cp -r swagger-ui-3.34.0/dist/* public/
創建index.js
文件并監聽端口3000:
vim index.js
修改以下內容:
var express = require('express');
var app = express();
var http = require('http');
app.use('/static', express.static('public'));
app.get('/', function (req, res) { res.send('Hello World!'); });
app.listen(3000, function () { console.log('Example app listening on port 3000!'); });
啟動index.js
服務:
node index.js
訪問http://<your-server-ip>:3000/static/index.html
確認可以訪問。
在Swagger-Editor中編寫你的接口文檔,并將生成的JSON文件保存到本地。
將JSON文件上傳至/opt/swagger/public
目錄。
修改/opt/swagger/public/index.html
文件中的URL,將其指向你的JSON文件:
url: "/static/你的JSON文件名"
刷新頁面即可查看自定義的接口文檔。
以上步驟應該可以幫助你在CentOS系統上成功配置Swagger。如果在配置過程中遇到任何問題,請參考相關的官方文檔或尋求社區幫助。