swagger ui

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访问了