前言
在社区群看到有人希望能够将kubesphere的文档自己搭一个环境跑起来使用,我想了下这个需求应该是实际使用确实会碰到的,比如某些公司内部网络规则禁止了一些网站或者只允许某些网站.
在这样的情况下自己搭建一个API文档网站还是很有必要的.
动起来
我首先去kubesphere的API网址看了下有没有提供下载文档json文件.
提醒: kubesphere API文档地址是https://kubesphere.io/api/kubesphere/
按钮还是很明显的,将文件下载下来.
API文档既然可以以文件的方式下载下来,那肯定可以再以某种方式加载,然后提供访问.
去swagger-ui的官方库看了看文档,找到了加载自定义json的方式,
地址是: https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/installation.md
执行的docker命令如下:
docker run -it -d --name swagger -p 80:8080 -e SWAGGER_JSON=/doc/kubesphere.json -v {文档文件目录}:/doc swaggerapi/swagger-ui
接着就可以通过访问本机本机IP来看kubesphere的API文档了.
总结
总的来说就两步:
- 下载kubesphere的API文档
- 用
swaggerapi/swagger-ui
容器把文档跑起来.