https://www.gitbook.com/book/rootsong…
Kubernetes 是 Google 基于 Borg 开源的容器编排调度引擎，作为 CNCF（Cloud Native Computing Foundation）最重要的组件之一，它的目标不仅仅是一个编排系统，而是提供一个规范，可以让你来描述集群的架构，定义服务的最终状态，它将自动得将系统达到和维持在这个状态。
本书记录了本人从零开始学习和使用 Kubernetes 的心路历程，着重于经验分享和总结，同时也会有相关的概念解析，希望能够帮助大家少踩坑，少走弯路。
在写作本书时，安装的所有组件、所用示例和操作等皆基于 Kubernetes1.6.0 版本。
如何使用本书
在线浏览
访问 gitbook
注意：文中涉及的配置文件和代码链接在 gitbook 中会无法打开，请下载 github 源码后，在 MarkDown 编辑器中打开，点击链接将跳转到你的本地目录，推荐使用typora。
本地查看
- 将代码克隆到本地
- 安装 gitbook：Setup and Installation of GitBook
- 执行 gitbook serve
- 在浏览器中访问http://localhost:4000
- 生成的文档在
_book目录下
生成 pdf
- On Mac
在Mac下安装后，使用该命令创建链接
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
在该项目目录下执行以下命令生成
kubernetes-handbook.pdf文档。gitbook pdf . ./kubernetes-handbook.pdf
- On Windows
- 将上述2个安装，calibre 默认安装的路径
C:\Program Files\Calibre2为你解压路径； - 并将其目录均加入到系统变量 path 中,参考:目录添加到系统变量 path 中；
- 在 cmd 打开你需要转 pdf 的文件夹,输入
gitbook pdf即可；
生成单个章节的pdf
使用
pandoc和latex来生成pdf格式文档。pandoc --latex-engine=xelatex --template=pm-template input.md -o output.pdf
如何贡献
提 issue
如果你发现文档中的错误，或者有好的建议，不要犹豫，欢迎 提交issue。
发起 Pull Request
当你发现文章中明确的错误或者逻辑问题，在你自己的 fork 的分支中，创建一个新的 branch，修改错误，push 到你的 branch，然后在 提交issue 后直接发起 Pull Request。
贡献文档
文档的组织规则
- 如果要创建一个大的主题就在最顶层创建一个目录；
- 全书五大主题，每个主题一个目录，其下不再设二级目录；
- 所有的图片都放在最顶层的
images目录下，原则上文章中用到的图片都保存在本地； - 所有的文档的文件名使用英文命名，可以包含数字和中划线；
etc、manifests目录专门用来保存配置文件和文档中用到的其他相关文件；
添加文档
- 在该文章相关主题的目录下创建文档；
- 在
SUMMARY.md中在相应的章节下添加文章链接； - 执行
gitbook server测试是否报错，访问 http://localhost:4000 查看该文档是否出现在相应主题的目录下；
from https://github.com/rootsongjc/kubernetes-handbook
No comments:
Post a Comment