如何在Ubuntu上安装Swagger

Question

我希望在Ubuntu上安装Swagger。 我对Swagger不熟悉。 我想使用Swagger进行API文档编写。 为此，我需要在我的计算机上安装什么？ 请尽快向我发送信息。

- satheesh

---

Ubuntu 版本？ - Arpit

我正在使用 Ubuntu 16.04。 - satheesh

你能发一些文档吗？如果有的话。 - satheesh

请参考此链接：http://blog.programster.org/ubuntu-14-04-installing-swagger。这个方法同样适用于Ubuntu 16.04。 - Arpit

我正在尝试启动npm，它显示请在任何支持请求中包含以下文件。 - satheesh

Answer 1

1. 安装node和npm，你只需下载node.tar.gz文件，可以浏览Node官方网站https://nodejs.org/en/download/current/
2. 解压缩此文件，并为npm和node设置全局参数，如果 node -v 和 npm -v 有结果，则说明安装成功
3. npm install -g http-server
4. git clone https://github.com/swagger-api/swagger-editor.git
5. http-server -p 8080 swagger-editor
6. 然后你就可以访问 http:127.0.0.1:8080 查看 Swagger 了！希望能帮到你！记得给我一个好评！

- julia

Answer 2

如果您正在使用Docker，只需拉取并运行swaggerapi/swagger-editor即可。

docker pull swaggerapi/swagger-editor
docker run -p 80:8080 swaggerapi/swagger-editor

打开你的浏览器，访问 http://localhost:80/ 注意，确保你的浏览器不会自动重定向到 https://localhost:80/

就像rugby2312提到的一样，你可以选择传入一个已存在的swagger.json文件。

mkdir tmp
cp swagger.json /tmp/swagger.json
docker run -d -p 80:8080 -v $PWD/tmp:/tmp -e SWAGGER_FILE=/tmp/swagger.json swaggerapi/swagger-editor

- rjdkolb

---

由于我已经在运行 LAMP 服务器，因此我使用以下命令来运行容器：docker run -d -p 8080:8080 swaggerapi/swagger-editor，以避免错误。 - bcag2

如果您想将现有的 swagger.json 传递给容器，请记得进行文件夹映射，并将文件名声明为变量 docker run -d -p 8080:8080 -v /home/ubuntu/dswagger:/tmp -e SWAGGER_FILE=/tmp/swagger.json swaggerapi/swagger-editor。 - rugby2312