TOC
前言
在社区群看到有人希望能够将 kubesphere 的文档自己搭一个环境跑起来使用,我想了下这个需求应该是实际使用确实会碰到的,比如某些公司内部网络规则禁止了一些网站或者只允许某些网站.
在这样的情况下自己搭建一个API文档网站还是很有必要的.
动起来
我首先去 kubesphere 的 API 网址看了下有没有提供下载文档 json 文件.
提醒: kubesphere API 文档地址是https://kubesphere.io/api/kubesphere/
[upl-image-preview url=https://kubesphere.com.cn/forum/assets/files/2021-04-13/1618290575-306140-image.png]
按钮还是很明显的,将文件下载下来.
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
上述命令中假定 swagger 文件名为kubesphere.json
,如果你的文件叫其他名字,记得修改成真实文件名.
接着就可以通过访问本机本机 IP 来看 kubesphere 的 API 文档了.
总结
总的来说就两步:
- 下载 swagger API 文档
- 用
swaggerapi/swagger-ui
容器把文档跑起来.
微信公众号
扫描下面的二维码关注我们的微信公众号,第一时间查看最新内容。同时也可以关注我的Github,看看我都在了解什么技术,在页面底部可以找到我的Github。