使用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

以上!

广告
将在 10 秒后关闭
bannerAds