Swagger UI 是一种非常流行的 API 文档管理工具，它可以根据 Swagger 规范自动生成文档，并提供一个用户友好的界面让开发者查看和测试 API。在 Docker 容器中使用 Swagger UI 可以让我们更加方便地管理 API 文档，本文将介绍如何在 Docker 容器中集成 Swagger UI。
前置知识
在开始本文之前，你需要具备以下技能：
- 熟悉 Docker 容器的基本概念和使用方法
- 熟悉 Swagger 规范及其使用方法
安装 Swagger UI
首先，我们需要在 Docker 容器中安装 Swagger UI。可以使用官方提供的 Docker 镜像，这里以版本为 v3.51.1 为例，执行以下命令：
docker pull swaggerapi/swagger-ui:v3.51.1
接下来，我们需要启动一个 Docker 容器，并将 Swagger UI 镜像挂载到容器中。执行以下命令：
docker run -p 8080:8080 -e SWAGGER_JSON=/api/swagger.json -v /path/to/swagger.json:/api/swagger.json swaggerapi/swagger-ui:v3.51.1
其中，-p 参数指定端口映射，-e 参数指定 Swagger UI 加载的 Swagger JSON 文件路径，-v 参数使用宿主机器上的 Swagger JSON 文件。
生成 Swagger JSON 文件
下一步，在 Docker 容器中使用 Swagger UI，我们需要准备一个 Swagger 规范格式的 JSON 文件。可以手动编写文件，也可以使用 Swagger 编辑器工具生成。在本文中，我们使用官方提供的 Petstore 示例。执行以下命令下载示例：
wget https://raw.githubusercontent.com/swagger-api/swagger-core/master/modules/swagger-samples/src/main/resources/petstore-openapi3.json -O /path/to/swagger.json
访问 Swagger UI
准备好 Swagger UI 和 Swagger JSON 文件后，我们可以通过浏览器访问 Swagger UI 界面。在浏览器中输入以下地址：
http://localhost:8080/
Swagger UI 界面将显示在浏览器中。
使用 Swagger UI
使用 Swagger UI 界面非常简单。在左侧的菜单中选择一个 API，就可以看到该 API 的详细说明和参数。还可以在 UI 中进行 API 测试。
使用 Swagger UI 还可以方便地查看 API 的文档，如请求参数、返回值等。这对 API 的使用和维护非常有帮助。
总结
本文介绍了如何在 Docker 容器中使用 Swagger UI 进行 API 文档管理。通过本文的学习，你将学会如何在 Docker 容器中安装 Swagger UI 并使用 Swagger 规范来生成 Swagger JSON 文件。使用 Swagger UI，我们可以更加方便地查看和管理 API 文档，提高了开发效率和可维护性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64ad17cf48841e989493e9b6