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接口。如果有任何問題，請參考相關文檔或尋求社區幫助。