在Ubuntu上安装Swagger,你可以选择使用Docker或者直接下载并安装Swagger的命令行工具。以下是两种方法的详细步骤:
安装Docker: 如果你还没有安装Docker,请先安装它。你可以使用以下命令来安装Docker:
sudo apt update
sudo apt install docker.io
安装完成后,启动Docker服务并设置开机自启:
sudo systemctl start docker
sudo systemctl enable docker
拉取Swagger UI镜像: 使用以下命令从Docker Hub拉取Swagger UI的镜像:
docker pull swaggerapi/swagger-ui
运行Swagger UI容器: 使用以下命令运行Swagger UI容器,并将本地的Swagger JSON文件挂载到容器中:
docker run -p 80:8080 -v /path/to/swagger.json:/usr/src/app/swagger.json swaggerapi/swagger-ui
其中,/path/to/swagger.json
是你本地的Swagger JSON文件的路径。
下载Swagger命令行工具: 访问Swagger的GitHub页面(https://github.com/swagger-api/swagger-ui),找到最新版本的Swagger命令行工具(swagger-cli),然后下载它。你可以使用以下命令来下载:
wget https://github.com/swagger-api/swagger-cli/releases/download/v2.0.24/swagger-cli.jar
请注意,上面的URL中的版本号可能会更新,你需要访问GitHub页面获取最新的版本号。
赋予执行权限: 下载完成后,赋予下载的JAR文件执行权限:
chmod +x swagger-cli.jar
使用Swagger命令行工具: 现在你可以使用Swagger命令行工具来验证和查看你的Swagger文档了。例如,使用以下命令来验证Swagger JSON文件:
java -jar swagger-cli.jar validate /path/to/swagger.json
其中,/path/to/swagger.json
是你本地的Swagger JSON文件的路径。
以上就是在Ubuntu上安装Swagger的两种方法。你可以根据自己的需求选择合适的方法。