Centos Swagger配置步骤是什么

centos

小樊

2025-02-18 23:43:06

栏目: 智能运维

在CentOS上配置Swagger的步骤如下：

1. 安装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.js和npm是否安装成功：

node -v
npm -v

2. 安装Swagger-Editor

新建一个目录用于存放Swagger相关文件，例如/opt/swagger，然后进入该目录：

mkdir /opt/swagger
cd /opt/swagger

下载并解压Swagger-Editor：

wget https://github.com/swagger-api/swagger-editor/archive/v3.14.0.tar.gz
tar -xf v3.14.0.tar.gz

进入解压后的目录并启动Swagger-Editor服务：

cd swagger-editor-3.14.0
npm install -g http-server
http-server -p 8081

访问http://172.28.128.20:8081/确认可以访问。

3. 安装Swagger-UI

回到/opt/swagger目录，下载并解压Swagger-UI：

wget https://github.com/swagger-api/swagger-ui/archive/v3.34.0.tar.gz
tar -xf v3.34.0.tar.gz

初始化Node.js项目并创建package.json文件：

cd /opt/swagger
mkdir public
cp -r swagger-ui-3.34.0/dist/* public/
npm init -y

安装Express并创建index.js文件，用于启动Swagger-UI：

npm install express --save
cat > index.js <<EOF
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!'); });
EOF

启动index.js文件：

node index.js

访问http://172.28.128.20:3000/static/index.html确认可以访问。

4. 配置Swagger-UI以显示自定义接口文档

在Swagger-Editor中编写自定义接口文档，并将文件保存为JSON格式。
将JSON文件上传至/opt/swagger/public目录。
修改/opt/swagger/public/index.html文件中的URL，指向你的JSON文件。
刷新Swagger-UI界面即可查看自定义接口文档。

以上步骤完成后，你就成功在CentOS上配置了Swagger。

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