溫馨提示×

centos swagger配置步驟

小樊
91
2025-02-14 04:24:15
欄目: 智能運維

在CentOS上配置Swagger的步驟如下:

安裝Node.js和npm

首先,你需要在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-UI

  1. 安裝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確認可以訪問。

  2. 安裝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-UI以顯示自定義接口文檔

  1. 在Swagger-Editor中編寫你的接口文檔,并將生成的JSON文件保存到本地。

  2. 將JSON文件上傳至/opt/swagger/public目錄。

  3. 修改/opt/swagger/public/index.html文件中的URL,將其指向你的JSON文件:

    url: "/static/你的JSON文件名"
    
  4. 刷新頁面即可查看自定義的接口文檔。

以上步驟應該可以幫助你在CentOS系統上成功配置Swagger。如果在配置過程中遇到任何問題,請參考相關的官方文檔或尋求社區幫助。

0
亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女