swagger介绍
swagger UI 是一款REST API文档在线自动生成和功能测试软件。
操作
(1) kubernetes的openapi访问地址为 http://:/openapi/v2,其内容为json格式的API说明文档,可以使用命令行工具curl进行查询
[root@f-master3 ~]# kubectl proxy --port=8082
[root@f-master3 ~]# curl localhost:8082/openapi/v2 | jq
(2) 整个Open API文档非常大,已文本方式不易查看和检索,可以通过其他Swagger UI工具使用浏览器查看,这样更加直观 方便
首先将OpenAPI文档导出为JSON文件,名称为k8s-swagger.json:
[root@f-master3 ~]# curl localhost:8082/openapi/v2 > k8s-swagger.json
(3) 启动容器
docker run \
--rm \
-d \
-p 8082:8080 \
-e SWAGGER_JSON=/k8s-swagger.json \
-v $(pwd)/k8s-swagger.json:/k8s-swagger.json \
swaggerapi/swagger-ui
然后就可以在浏览器上使用ip+port访问了