Swagger于Linux怎样部署应用

在Linux上部署Swagger主要涉及到使用Swagger UI来查看和测试API接口。以下是一个基本的步骤指南，假设你使用的是基于Spring Boot的项目。

1. 安装Swagger UI

首先，你需要在你的Spring Boot项目中添加Swagger依赖。如果你使用的是Maven，可以在pom.xml文件中添加以下依赖：

<!-- Swagger2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

<!-- Swagger3 (OpenAPI3) -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

2. 配置Swagger

在你的Spring Boot应用中配置Swagger。创建一个配置类，例如SwaggerConfig.java，并添加以下内容：

import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
}

3. 访问Swagger UI

启动你的Spring Boot应用后，你可以通过以下URL访问Swagger UI：

• 对于Swagger2：http://localhost:8080/swagger-ui.html
• 对于Swagger3（OpenAPI3）：http://localhost:8080/swagger-ui/index.html

4. 使用Swagger UI测试API

打开Swagger UI页面后，你可以看到你的API接口列表。点击相应的接口，可以查看请求示例和测试功能。

5. 使用Docker部署（可选）

如果你希望在Linux服务器上部署你的应用，可以使用Docker来简化部署过程。以下是一个简单的Dockerfile示例：

# 使用官方的Spring Boot镜像作为基础镜像
FROM openjdk:11-jre-slim

# 设置工作目录
WORKDIR /app

# 复制构建好的JAR文件到镜像中
COPY target/your-application.jar /app/your-application.jar

# 运行应用
ENTRYPOINT ["java", "-jar", "your-application.jar"]

构建并运行Docker容器：

docker build -t your-application .
docker run -p 8080:8080 your-application

参考资源

• SpringBoot学习小结之Swagger

通过以上步骤，你应该能够在Linux上成功部署并运行Swagger UI来查看和测试你的API接口。如果有任何问题，请参考相关文档或寻求社区帮助。