在Linux环境下将Swagger与Kubernetes集成，可以让开发者通过Web界面方便地查看和管理Kubernetes集群中的API文档。以下是详细的步骤：
首先，确保你的Linux系统上已经安装了Java环境和Maven或Gradle。Swagger是一个基于Java的API文档生成工具，因此需要Java开发环境。你可以使用OpenJDK或Oracle JDK来安装Java。
# 安装Java环境 sudo apt update sudo apt install openjdk-11-jdk # 设置Maven或Gradle（以Maven为例） echo "maven.repo.local=/home/yourusername/.m2/repository" > ~/.m2/settings.xml 在你的项目中添加Swagger依赖项。如果你使用的是Spring Boot项目，可以使用springfox-boot-starter。
Maven:
<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> Gradle:
dependencies { implementation 'io.springfox:springfox-boot-starter:3.0.0' } 创建一个Swagger配置类来启用Swagger文档生成。
Spring Boot:
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.any()) .paths(PathSelectors.any()) .build(); } } 你可以通过Docker容器来部署Swagger UI和Swagger Editor。
部署Swagger UI:
# 拉取Docker镜像 docker pull swaggerapi/swagger-ui:v4.15.5 # 运行Docker容器 docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5 部署Swagger Editor:
# 拉取Docker镜像 docker pull swaggerapi/swagger-editor:v4.6.0 # 运行Docker容器 docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0 启动你的Spring Boot或Spring MVC应用程序后，你可以通过浏览器访问Swagger UI来查看和测试API文档。
http://localhost:38081/swagger-ui/index.html 如果你需要在Kubernetes集群中部署和运行Swagger，可以使用Kubernetes的Deployment和Service资源来管理Swagger UI和Swagger Editor的部署。
Swagger UI Deployment示例:
apiVersion: apps/v1 kind: Deployment metadata: name: swagger-ui spec: replicas: 1 selector: matchLabels: app: swagger-ui template: metadata: labels: app: swagger-ui spec: containers: - name: swagger-ui image: swaggerapi/swagger-ui:v4.15.5 ports: - containerPort: 8080 Swagger UI Service示例:
apiVersion: v1 kind: Service metadata: name: swagger-ui-service spec: selector: app: swagger-ui ports: - protocol: TCP port: 80 targetPort: 38081 type: LoadBalancer 通过以上步骤，你可以在Linux系统中成功集成Swagger与Kubernetes，并通过Kubernetes进行管理和部署。希望这些信息对你有所帮助！
