Ubuntu Swagger如何进行部署

865
2025/4/9 9:31:47
栏目: 智能运维
开发者测试专用服务器限时活动,0元免费领,库存有限,领完即止! 点击查看>>

在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
  1. 安装Express和其他必要的模块
npm install -g express body-parser cookie-parser multer
  1. 创建并配置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");
});
  1. 下载并部署Swagger UI
  • GitHub克隆Swagger UI仓库。
  • dist目录中的文件复制到Express应用的public目录中。
  1. 启动Express应用
node index.js
  1. 访问Swagger UI
  • 在浏览器中访问http://localhost:3000/swagger

方法二:使用Swagger Editor

  1. 安装Node.js和npm(与方法一相同)。

  2. 安装http-server

npm install -g http-server
  1. 下载并部署Swagger Editor
  • GitHub克隆Swagger Editor仓库。
  • 在Swagger Editor目录下运行http-server
cd swagger-editor
http-server -p 8080
  1. 访问Swagger Editor
  • 在浏览器中访问http://localhost:8080

方法三:使用Nginx

  1. 安装Nginx
sudo apt-get install nginx
  1. 下载Swagger Editor和Swagger UI
  • GitHubGitHub分别下载Swagger Editor和Swagger UI的源码。
  1. 配置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;
    }
}
  1. 重启Nginx
sudo systemctl restart nginx
  1. 访问Swagger Editor和Swagger UI
  • 在浏览器中分别访问http://localhost/swagger-editorhttp://localhost/swagger-ui

辰迅云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>

推荐阅读: Ubuntu中C++库文件在哪找