如何利用Swagger在Linux上进行API文档的持续集成

以下是在Linux上利用Swagger实现API文档持续集成的步骤：

1. 安装基础环境
   • 安装Java（11+）和构建工具（Maven/Gradle）：

     sudo apt update && sudo apt install openjdk-11-jdk maven
     

2. 添加Swagger依赖
   • Maven项目在pom.xml中添加：

     <dependency>
         <groupId>org.springdoc</groupId>
         <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
         <version>2.6.0</version> <!-- 以最新版为准 -->
     </dependency>
     

3. 配置Swagger
   • 创建配置类（Spring Boot示例）：

     @Configuration
     public class SwaggerConfig {
         @Bean
         public OpenAPI customOpenAPI() {
             return new OpenAPI()
                 .info(new Info().title("API文档").version("1.0"));
         }
     }
     

4. 集成到CI/CD工具
   • Jenkins：在Jenkinsfile中添加文档生成步骤：

     stage('Generate Swagger Docs') {
         steps {
             sh 'mvn springdoc:generate'
         }
         post {
             archiveArtifacts artifacts: 'target/generated-docs/**'
         }
     }
     

   • GitLab CI/CD：在.gitlab-ci.yml中配置：

     stages:
       - document
     generate_docs:
       stage: document
       script:
         - mvn springdoc:generate
       artifacts:
         paths:
           - target/generated-docs
     

5. 自动化测试与部署
   • 集成测试工具（如JUnit）验证API功能，通过CI/CD管道自动部署文档到Web服务器（如Nginx）。

说明：Spring Boot 3.x推荐使用springdoc-openapi替代旧版springfox，支持OpenAPI 3.0规范，生成文档更简洁。