Linux中Swagger的版本管理怎么做

在Linux系统中进行Swagger的版本管理，通常涉及以下几个方面：

1. 使用版本控制系统（VCS）

• Git：推荐使用Git进行版本控制。首先，在项目根目录初始化Git仓库：

  git init
  

• 添加远程仓库：将本地仓库与远程仓库（如GitHub、GitLab等）关联：

  git remote add origin 
  

• 提交代码：在开发过程中，将每次修改添加到暂存区并提交到本地仓库：

  git add .
  git commit -m "描述提交内容的简短信息"
  

• 拉取和推送：从远程仓库拉取最新代码，并将本地修改推送到远程仓库：

  git pull origin 
  git push origin 
  

2. 更新Swagger UI和Swagger Codegen

• 更新Swagger UI：

  1. 打开终端。

  2. 使用wget命令下载最新版本的Swagger UI：

     wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v2.4.27.zip
     

  3. 解压下载的Swagger UI文件：

     unzip v2.4.27.zip
     

  4. 将解压后的Swagger UI文件复制到项目中，并更新项目中的HTML、CSS和JavaScript文件，以引用新版本的Swagger UI资源。

• 更新Swagger Codegen：

  1. 打开终端。

  2. 使用wget命令下载最新版本的Swagger Codegen：

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

  3. 将下载的Swagger Codegen JAR文件复制到项目中。

  4. 创建一个名为codegen.sh的脚本文件，并添加以下内容：

     #!/bin/bash
     java -jar /path/to/swagger-codegen-cli-2.4.27.jar generate -i http://petstore.swagger.io/v2/api-docs -l java -o /path/to/output/directory
     

  5. 为脚本文件添加可执行权限：

     chmod +x codegen.sh
     

3. 版本控制中的Swagger版本管理

• 在代码中建立一个ApiVersions.cs文件，用来设置版本：

  public enum ApiVersions {
      V1,
      V2,
      V3
  }
  

• 在Program.cs文件中修改相应的内容，启用Swagger版本控制，并为每个版本配置相应的Swagger文档：

  builder.Services.AddSwaggerGen(options => {
      options.SwaggerDoc(ApiVersions.V1.ToString(), new OpenApiInfo { Title = "V1: API文档", Version = ApiVersions.V1.ToString() });
      options.SwaggerDoc(ApiVersions.V2.ToString(), new OpenApiInfo { Title = "V2: API文档", Version = ApiVersions.V2.ToString() });
      options.SwaggerDoc(ApiVersions.V3.ToString(), new OpenApiInfo { Title = "V3: API文档", Version = ApiVersions.V3.ToString() });
  });
  

• 在控制器文件里面添加版本控制：

  [ApiExplorerSettings(IgnoreApi = false, GroupName = nameof(ApiVersions))]
  public class CompanyController : ControllerBase { }
  

通过上述步骤，可以在Linux系统中有效地管理Swagger的版本，确保API文档的更新和维护更加规范和可控。