Debian下Swagger与Kubernetes如何集成

在Debian操作系统中将Swagger与Kubernetes进行整合，可按照如下流程操作：

Debian系统安装Swagger步骤

1. 更新软件包列表并升级已安装的包：

sudo apt update && sudo apt upgrade -y

2. 安装Node.js和npm（若尚未安装）：

curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install -y nodejs

3. 全局安装Swagger UI：

sudo npm install -g swagger-ui

4. 启动Swagger UI服务：

swagger-ui --host localhost:3000

随后，你可以在浏览器中打开 https://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4 来使用Swagger UI。

在Spring Boot项目中启用Swagger

1. 生成Spring Boot工程： 通过Spring Initializr创建一个新工程，并确保引入spring-boot-starter-web和spring-boot-starter-security模块。
2. 添加Swagger依赖项： 在pom.xml文件里加入以下springfox-boot-starter依赖：

io.springfoxspringfox-boot-starter3.0.0

3. 配置Swagger参数： 创建一个新的配置类用于设定Swagger相关选项。

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.EnableSwagger2WebMvc;
@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.basePackage("com.example"))
.paths(PathSelectors.any())
.build();
}
}

4. 编写测试用控制器： 创建一个简单的REST控制器以供测试：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/api")
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "Hello, Swagger!";
}
}

5. 运行Spring Boot应用：

./mvnw spring-boot:run

6. 访问Swagger用户界面： 打开浏览器，输入以下地址：

https://www.php.cn/link/3f2624ba9ffc5ebd40c98284e1379e99

此时应能看到Swagger UI界面，并浏览到所定义的API文档。

NatAgent

AI数据情报监测与分析平台

下载

Kubernetes部署Swagger组件

1. 创建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.6.0
ports:
containerPort: 8080

2. 创建Swagger Editor的Deployment：

apiVersion: apps/v1
kind: Deployment
metadata:
name: swagger-editor
spec:
replicas: 1
selector:
matchLabels:
app: swagger-editor
template:
metadata:
labels:
app: swagger-editor
spec:
containers:
name: swagger-editor
image: swaggerapi/swagger-editor:v4.6.0
ports:
containerPort: 8080

3. 访问Swagger UI页面： 启动你的Spring Boot或Spring MVC应用后，在浏览器中输入如下URL来查看和调用API接口：

https://www.php.cn/link/49f925ccf67d449d8ca3ad8b5b8fea76

通过上述步骤，即可实现在Debian平台上将Swagger整合进Spring Boot应用，并借助Kubernetes完成容器化部署。