Kubernetes中文指南/云原生应用架构实战手册 - https://jimmysong.io/kubernetes-handbook
 
 
 
 
 
 
Go to file
Jimmy Song 1509cd9f40 Merge pull request #47 from xiaods/patch-1
fix typo for gitbook
2017-09-10 15:36:58 +08:00
appendix 增加issue kubernetes 集成 ceph 存储 rbd 命令组装问题 2017-09-06 17:25:56 +08:00
concepts 增加network policy译文 2017-09-03 14:17:52 +08:00
develop 增加kubernetes官方文档汉化项目 2017-09-03 13:18:38 +08:00
etc 增加使用Ceph做持久化存储创建MySQL集群 2017-09-01 20:54:59 +08:00
guide chagne file name 2017-09-07 14:12:55 +08:00
images 增加IP伪装代理 2017-09-07 14:09:36 +08:00
manifests 增加使用Ceph做持久化存储创建MySQL集群 2017-09-01 20:54:59 +08:00
practice 修改文中的一些小问题 2017-09-08 11:18:34 +08:00
systemd 增加docker安装时的环境变量文件配置 2017-08-02 23:06:44 +08:00
usecases 增加开发文档 2017-09-09 22:40:26 +08:00
.gitignore 更新网址 2017-08-22 11:42:11 +08:00
LICENSE merged 2017-05-18 12:50:20 +08:00
Makefile 增加Makefile 2017-06-22 12:09:47 +08:00
README.md fix typo for gitbook 2017-09-08 20:14:05 +08:00
SUMMARY.md 修改文中的一些小问题 2017-09-08 11:18:34 +08:00
book.json merged 2017-05-18 12:50:20 +08:00
cover.jpg 重大改版 2017-05-20 21:03:25 +08:00
pm-template.latex 增加latex的模版 2017-04-27 11:08:31 +08:00
wercker.yml 修改wercker配置 2017-06-22 12:07:24 +08:00

README.md

Kubernetes Handbook

Kubernetes 是 Google 基于 Borg 开源的容器编排调度引擎,作为 CNCFCloud Native Computing Foundation最重要的组件之一它的目标不仅仅是一个编排系统而是提供一个规范可以让你来描述集群的架构定义服务的最终状态它将自动得将系统达到和维持在这个状态。

本书记录了本人从零开始学习和使用 Kubernetes 的心路历程,着重于经验分享和总结,同时也会有相关的概念解析,希望能够帮助大家少踩坑,少走弯路。

在写作本书时,安装的所有组件、所用示例和操作等皆基于 Kubernetes1.6.0 版本。

文章目录

GitHub 地址:https://github.com/rootsongjc/kubernetes-handbook

Gitbook 在线浏览:http://jimmysong.io/kubernetes-handbook/

如何使用本书

在线浏览

访问 http://jimmysong.io/kubernetes-handbook/

注意:文中涉及的配置文件和代码链接在网页中将无法访问,请下载 github 源码后,在 Markdown 编辑器中打开,点击链接将跳转到你的本地目录,推荐使用 typora,或者直接登录 github 查看。

本地查看

  1. 将代码克隆到本地
  2. 安装 gitbookSetup and Installation of GitBook
  3. 执行 gitbook serve
  4. 在浏览器中访问 http://localhost:4000
  5. 生成的文档在 _book 目录下

下载 PDF/ePub/Mobi 格式文档本地查看

访问 gitbook 可以看到下载地址,可以下载根据最新文档生成的 PDF/ePub/Mobi 格式文档(文档的注脚中注明了更新时间),同时也可以直接在 gitbook 中阅读,不过 gitbook 不太稳定打开速度较慢,建议大家直接在 http://jimmysong.io/kubernetes-handbook/ 浏览。

生成 pdf

下载Calibre

  • 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

需要用到的工具:calibrephantomjs

  1. 将上述2个安装calibre 默认安装的路径 C:\Program Files\Calibre2 为你解压路径;
  2. 并将其目录均加入到系统变量 path 中,参考:目录添加到系统变量 path 中;
  3. 在 cmd 打开你需要转 pdf 的文件夹,输入gitbook pdf即可;

生成单个章节的pdf

使用pandoclatex来生成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 目录下,原则上文章中用到的图片都保存在本地;
  • 所有的文档的文件名使用英文命名,可以包含数字和中划线;
  • etcmanifests目录专门用来保存配置文件和文档中用到的其他相关文件;

添加文档

  1. 在该文章相关主题的目录下创建文档;
  2. SUMMARY.md 中在相应的章节下添加文章链接;
  3. 执行 gitbook serve 测试是否报错,访问 http://localhost:4000 查看该文档是否出现在相应主题的目录下;
  4. 提交PR

关于

贡献者列表

Jimmy Song