使用Mac从Docker启动Swagger并验证API模拟服务器的操作
使用Mac从docker启动swagger,并进行API模拟服务器的操作验证
-
- docker インストール
-
- swagger-ui イメージの起動
-
- nodejs-server ダウンロード
-
- node インストール
- nodejs-server 起動
安装Docker
从这里下载并安装稳定版。
https://docs.docker.com/docker-for-mac/install/
启动 swagger-ui 的镜像。
docker pull swaggerapi/swagger-ui
docker run -d -p 8888:8080 swaggerapi/swagger-editor
用pull命令下载并启动。
顺便提一下,为了使node服务器在最后启动时监听8080端口,我选择了8888端口来启动。
下载Node.js服务器。
请从顶部菜单中依次点击:
生成服务器 > Node.js 服务器,
然后下载 nodejs-server-server-generated.zip。
顺便提一句,在官方在线编辑器里无法下载。为什么呢?
这里使用Docker启动的Swagger已经不再需要了,可以关闭它。
docker ps
docker stop psで表示されたid
安装节点
nodebrew 安装
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install nodebrew
nodebrew setup
安装Node
nodebrew install-binary latest
nodebrew list
在已安装的版本列表中显示可供选择的选项,并选择您喜欢的一个。
nodebrew use vXXX.XX.XX
继而进行路径等设置
使用bash时↓
vi ~/.bash_profile
if [ -f ~/.bashrc ] ; then
. ~/.bashrc
fi
echo 'export PATH=$PATH:$HOME/.nodebrew/current/bin' >> ~/.bash_profile
如果使用zsh↓
vi ~/.zshrc
path=(
$PATH:$HOME/.nodebrew/current/bin(N-/)
$path
)
添加
使用Node.js启动服务器。
在任意位置解压缩通过“nodejs-server ダウンロード”下载的nodejs-server-server-generated.zip文件。
参考下面的内容,将“展开文件夹/api/swagger.yaml”的host和schemes修改为本地执行所需的设置。
host: "localhost:8080"
schemes:
- "http"
在终端中切换到 nodejs-server-server 文件夹。
npm install
待执行后再启动。
node index.js
这样启动就完成了,然后在http://localhost:8080/docs/上访问,会启动本地的Swagger UI API模拟服务器。打开折叠的API设计文档,设置响应后点击“Try it out!”,按照显示的访问方法进行访问,确认一下就好了。
順带一提,当你要确认的时候,请检查显示内容。
curl -X ...
不是,而是。
curl -verbose -X ...
这个的话,我建议选择……
要结束服务器
ps -e | grep node | awk '{print $1}'
kill -9 表示されたid
以上!