在Docker映像中使用本地json文件运行Swagger

在docker命令中 -v 是指装入卷和 -e 意味着添加环境变量,因此您需要的可能是:

docker run -p 8081:8080 -e SWAGGER_JSON=/mnt/lp.json -v /Users/abc/Desktop:/mnt swaggerapi/swagger-ui

对我来说,执行命令很有帮助

docker run -p 8081:8080 -e SWAGGER_JSON=/tmp/swagger.json -v `pwd`/docs:/tmp swaggerapi/swagger-ui:v3.21.0

“pwd”/文档=>包含我的狂妄自大。json文件。

swaggerapi/swagger ui:v3。21.0=>此版本支持SWAGGER\u JSON。其已测试。

我在Windows上的工作方式是:

docker run -p 80:8080 -e SWAGGER_JSON=/mnt/swagger-v1.json -v C:\Users\jimen\Downloads:/mnt swaggerapi/swagger-ui

哪里 C:\Users\jimen\Downloads 是本地swagger文件所在的文件夹( swagger-v1.json )。

我真的想要 swagger-editor 而不是 swaggerapi/swagger-ui :

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

然后你会得到一个完整的 File 菜单:

而不是指定 SWAGGER_JSON 您可以执行以下操作,立即在Swagger UI中打开API规范:

docker run --name my-swagger-ui -p 80:8080 -e URL=api/openapi.yaml -v ${PWD}://usr/share/nginx/html/api swaggerapi/swagger-ui:v3.51.1

这也是用最新的 swagger-ui 一天前发布的图像。

注: 我从Windows运行此命令,从而指定了环境变量 ${PWD} 在Linux中可能有点不同。

幕后发生了什么

这里发生的事情是,您装载一个卷( -v ${PWD}://usr/share/nginx/html/api )在包含您的招摇过市规范的nginx html文件夹中(在本例中 openapi.yaml ).带 -e URL=api/openapi.yaml 默认URL将被覆盖,而将使用您的招摇过市规范。