前后端分离必备工具:Swagger快速搞定(整合SpringBoot详细教程)
【狂神说Java】一小时掌握Swagger技术
swagger url
背景
背景:集群项目
服务器 ip:10.1.193.12 用户名:controller-12
myweb-test-service 为集群中 svc 之一 ,对应的 pod 为 myweb-test-423nkjn43uihj-i32ij
[root@controller-12 ~]# k get svc -A | grep myweb
NAME TYPE CLUSTER-IP PORT(S) AGE
myweb-test-service ClusterIP 10.231.21.103 8080/TCP 22d
[root@controller-12 ~]# k get po -A -o wide | grep myweb
NAME READY STATUS RESTARTS AGE IP NODE
myweb-test-423nkjn43uihj-i32ij 1/1 Running 0 4h39m 10.5.192.29 controller-12
application.yaml
# 没有配置 spring.profiles ,为 默认环境
server:
port: 30210
servlet:
context-path: /myweb-test #根路径名
...
---
server:
port: 32013
spring:
profiles: test #测试环境
...
--- #yaml中可以配两套配置 使用 --- 隔开,并通过 spring.profiles 指定环境
spring:
profiles: k8s #k8s集群环境
...
server:
port: 8080
...
这时如果启动项目,使用的便是默认的环境,如果要想使用dev或者test环境,只需要在默认的环境下面加上
spring:
profiles:
active: dev
线下debug访问
访问 myweb-test
http://localhost:debug_ip/context-path/swagger-ui.html#/
http://localhost:30210/myweb-test/swagger-ui.html
访问服务器上的模块
pod_ip:container_port/context-path/swagger-ui.html
svc_name.svc_namespace.svc.cluster.local:8080/application_context-path/swagger-ui.html#/
http://10.5.192.29:8080/myweb-test/swagger-ui.html#/
http://myweb-service.default.svc.cluster.local:8080/myweb/swagger-ui.html#/
context-path
找 application.yaml 中的 server.servlet.context-path
,一般就是 svc 名称
container_ip
可以看 application.yaml k8s环境下的 port 配置
,或者 k get po -n test myweb-test-423nkjn43uihj-i32ij -o yaml | grep port
查看
发给同事的swagger
项目访问ip:项目端口port/模块名称/swagger-ui.html
比如上面的pod,svc 都是为了支持myweb项目的,其中一个模块 context-path 是 myweb
myweb访问链接 http://10.2.196.111:30101/
则发给同事 http://10.2.196.111:30101/myweb/swagger-ui.html
问题
swagger 不通,浏览器一直转圈
1 网速问题
,等一会就出来了
2 用的是不是 pod 还是 svc 的访问链接
,如果是,要连对应服务器的 vpn
3 用 项目访问ip:项目端口port/模块名称/swagger-ui.html