狂神swagger

前后端分离必备工具：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