Swagger在Ubuntu中的集成方式

Swagger在Ubuntu中的集成方式主要有以下几种：

1. 使用Docker部署

   • 安装Docker：sudo apt update && sudo apt install docker.io。
   • 拉取Swagger UI镜像：docker pull swaggerapi/swagger-ui。
   • 运行容器并挂载配置文件：docker run -p 8080:8080 -v /path/to/swagger.json:/usr/src/app/swagger.json swaggerapi/swagger-ui。
   • 访问：http://localhost:8080。

2. 基于Node.js集成

   • 安装Node.js和npm：sudo apt install nodejs npm。
   • 安装Swagger工具：npm install -g swagger-jsdoc swagger-ui-express。
   • 创建swagger.json或swagger.yaml配置文件。
   • 在Express应用中集成：

     const express = require('express');  
     const swaggerUi = require('swagger-ui-express');  
     const swaggerDocument = require('./swagger.json');  
     const app = express();  
     app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));  
     app.listen(3000, () => console.log('Server running on port 3000'));  
     

   • 访问：http://localhost:3000/api-docs。

3. 使用Java环境（需搭配Spring Boot等框架）

   • 安装Java和Maven：sudo apt install openjdk-11-jdk maven。
   • 配置swagger.yaml文件。
   • 启动Spring Boot应用：java -jar target/your-app.jar。
   • 访问：http://localhost:8080/swagger-ui.html。

说明：

• Docker方式适合快速部署，无需额外配置环境。
• Node.js方式轻量级，适合前后端分离项目。
• Java方式适合Spring Boot项目，需结合框架使用。