Centos Swagger如何更新升级

CentOS系统更新Swagger的常用方法

一、更新Swagger UI（前端文档展示工具）

Swagger UI是Swagger生态中用于可视化API文档的前端工具，更新步骤如下：

1. 下载最新版本：访问Swagger UI的GitHub仓库Releases页面，获取最新版本的下载链接（如v4.15.5）。使用wget命令下载压缩包（将链接替换为实际地址）：

   wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v4.15.5.zip
   

2. 解压并替换旧文件：解压下载的压缩包，将解压后的dist文件夹（包含最新版Swagger UI资源）复制到项目的前端静态资源目录（如/var/www/html/swagger），覆盖旧文件：

   unzip v4.15.5.zip
   cp -r swagger-ui-4.15.5/dist/* /var/www/html/swagger/
   

3. 验证更新：通过浏览器访问项目中的Swagger UI页面（如http://your-server-ip/swagger），检查页面样式、功能及版本号（通常位于页面底部）是否更新。

二、更新Swagger Codegen（代码生成工具）

Swagger Codegen用于根据OpenAPI/Swagger定义文件生成客户端/服务端代码，更新步骤如下：

1. 下载最新JAR文件：访问Swagger Codegen的Maven仓库Releases页面，获取最新版本的JAR文件链接（如swagger-codegen-cli-3.0.34.jar）。使用wget命令下载：

   wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/3.0.34/swagger-codegen-cli-3.0.34.jar
   

2. 替换旧JAR文件：将下载的最新JAR文件复制到项目的工具目录（如/opt/swagger-tools），覆盖旧文件（建议备份旧文件）：

   mv swagger-codegen-cli-3.0.34.jar /opt/swagger-tools/swagger-codegen-cli.jar
   

3. 测试代码生成：通过命令行运行最新版Codegen，生成测试代码（以Java为例）：

   java -jar /opt/swagger-tools/swagger-codegen-cli.jar generate -i swagger.yaml -l java -o ./generated-code
   

   检查生成的代码是否符合预期（如结构、注解是否更新）。

三、更新项目中的Swagger依赖（后端集成）

若项目通过Maven或Gradle集成了Swagger（如Spring Boot项目使用SpringFox或SpringDoc），需更新依赖版本：

1. 修改依赖配置：
   • Maven项目：编辑pom.xml文件，更新springfox-boot-starter（SpringFox）或springdoc-openapi-starter-webmvc-ui（SpringDoc）的版本号（如SpringDoc从2.1.0升级到2.2.0）：

     <dependency>
         <groupId>org.springdoc</groupId>
         <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
         <version>2.2.0</version>
     </dependency>
     

   • Gradle项目：编辑build.gradle文件，更新依赖版本：

     implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.2.0'
     

2. 重新构建并部署：运行mvn clean install（Maven）或./gradlew build（Gradle）重新构建项目，将生成的JAR/WAR文件部署到CentOS服务器（如复制到/opt/tomcat/webapps），并重启应用服务：

   systemctl restart tomcat
   

3. 验证更新：访问项目的Swagger UI页面（如http://your-server-ip:8080/swagger-ui.html），检查页面是否显示最新版本信息，且API文档是否正常加载。

四、注意事项

• 备份数据：更新前备份项目配置文件（如swagger.yaml）、代码及数据库，避免升级失败导致数据丢失。
• 兼容性检查：阅读新版Swagger的发布说明和迁移指南，确保新版本与现有项目技术栈（如Spring Boot版本）兼容。
• 依赖冲突解决：若更新后出现依赖冲突（如Maven的dependency:tree显示冲突），需调整依赖版本或使用<exclusions>排除冲突的依赖。