centos 7 搭建 Swagger Editor + Swagger-UI

一、install Node.js and npm on CentOS 7
  1. 通过 SSH 方式登录到你的 VPS
ssh user@vps_IP
  1. Update the system and install necessary packages
yum install curl sudo
  1. 从 NodeSource repository 安装 Node.js and npm

To enable the EPEL repository on your CentOS 7 VPS, issue the following command:

sudo yum install epel-release

添加 Node.js v8 LTS repository:

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -

Once the NodeSource repository is enabled we can proceed with the Node.js v8 LTS and npm installation:

sudo yum install nodejs
  1. Install build tools

To compile and install native addons from the npm repository we also need to install build tools:

sudo yum install gcc-c++ make

验证 Node.js 安装是否成功:

node -v 

验证 npm 安装是否成功:

npm -v

以上两个如果结果显示对应版本号,说明安装成功。否则,请重新安装。

二、安装 Swagger-Editor

在服务器上新建目录,我在公共机上以我的名字建了一个文件夹 changyou。

cd changyou

进入 changyou 目录,下载 swagger-editor 最新版本到这里。

下载完成,后解压

tar -xvf swagger-editor-3.6.6.tar

然后切换到根目录,开始安装 node.js HttpServer

npm install -g http-server

安装完成后,再次切换到 changyou 目录下,执行命令,启动服务:

http-server swagger-editor 以8080端口启动项目 
http-server –p 8082 swagger-editor 指定端口启动项目
http-server -p 8081 swagger-editor-3.6.6

这样就可以在浏览器访问 swagger-editor 了,如 http://127.0.0.1:8081/

三、安装 Swagger-UI
  1. 进入 changyou 目录,下载并解压最新 Swagger-UI 包到这里。
cd changyou
  1. 创建一个空文件夹 swagger , cd 到该目录下。
cd swagger
  1. 初始化 node ,创建package.json文件()
npm init
// 根据提示,自行填写
name: (node_app) node_app
version: (1.0.0)
description:
entry point: (index.js)
test command:
git repository:
keywords:
author:
license: (ISC)
  1. 安装 express
npm install express --save

这一步不要忘记了,开始我没有执行这个,后来怎么都安装不成功,白白浪费了好多时间。

  1. 创建 index.js
vim index.js 

把下面代码贴如 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!');
});

此处注意 app.use('/static', express.static('public')); 是新添加的,需要根据这个定位项目路径。

  1. 在 swagger 中创建空目录 public

把下载好的 Swagger UI 文件中 dist 目录下的全部文件复制到 public 文件夹下。
将 index.html 文件中的 javascript 代码的 url 修改为 /static/test.json

  1. 生成 test.json

使用前面搭建好的 Swagger Editor 编辑一个 test.json 文件,并上传到 changyou/swagger/public ,这个用于下面的测试。

项目结构图
  1. cd 到 changyou/swagger 目录,重启 node 服务器
node index.js

浏览器打开 http://127.0.0.1:3000/static/index.html

至此 Node.js +Swagger Editor + Swagger-UI 环境搭建完成,Perfect !

附:服务器后台启动进程

// 后台启动进程,退出命令行不取消进程
nohup http-server -p 8081 swagger-editor-3.6.6 & 
// 后台启动进程,退出命令行不取消进程
nohup http-server -p 8081 swagger-editor-3.6.6 & 

// 查询进程
ps aux|grep flume 

// 根据端口号查询进程
lsof -i:8081 

// 杀掉进程:
kill -9 xxxxx

// 安全退出命令行登录 
exit

参考:

  1. how-to-install-node-js-and-npm-on-centos-7
  2. Node.js +Swagger Editor + Swagger-UI 环境搭建
  3. Swagger UI教程 API 文档神器 搭配Node使用
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容