如何在GKE 1.9集群中启用Kubernetes API Server集成的Swagger UI？

嘿，好消息！GKE上的Kubernetes API Server默认已经集成了Swagger UI，你不需要额外安装任何组件，只需要通过正确的方式暴露访问路径就行。下面是两种最常用的方法：

方法一：使用kubectl Proxy（推荐） #

这是最简单且安全的方式，kubectl会自动处理与API Server的认证和授权：

1. 首先确保你的本地kubectl已经配置好GKE集群的访问凭证：
   如果你还没配置，运行这条命令（替换成你的集群名和区域）：

   gcloud container clusters get-credentials YOUR_CLUSTER_NAME --region YOUR_REGION
   

2. 启动kubectl proxy，将本地端口转发到API Server：

   kubectl proxy --port=8080
   

3. 打开浏览器，访问以下地址就能看到Swagger UI了：

   http://localhost:8080/swagger-ui/
   

   如果这个路径打不开，试试完整的索引页路径：http://localhost:8080/swagger-ui/index.html

方法二：直接端口转发到API Server（可选） #

如果你不想用kubectl proxy，也可以直接端口转发到API Server的端口（默认6443），但需要处理证书问题：

1. 获取API Server的地址：

   kubectl cluster-info | grep "Kubernetes control plane"
   

2. 端口转发（替换成你的API Server地址）：

   sudo ssh -L 8080:YOUR_API_SERVER_ADDRESS:6443 localhost
   

不过这种方法访问时浏览器会提示SSL证书不安全，操作起来不如kubectl proxy方便，所以更推荐第一种方法。

注意事项 #

• 确保你的kubectl用户拥有足够的权限访问API Server（默认的集群管理员权限肯定没问题）
• 如果是GKE私有集群，你的本地机器需要能访问集群的控制平面网络（比如通过VPN、Cloud VPN或者在同一个VPC内的机器）
• 新版本的Kubernetes中，Swagger UI可能会被OpenAPI UI替代，但访问路径基本一致，功能类似

内容的提问来源于stack exchange，提问作者jraj