rootsongjc
/
kubernetes-handbook
mirror of https://github.com/rootsongjc/kubernetes-handbook.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Kubernetes中文指南/云原生应用架构实战手册 - https://jimmysong.io/kubernetes-handbook
596 Commits
2 Branches
8 Tags
451 MiB
Shell 42.2%
JavaScript 31.8%
Smarty 13.1%
Dockerfile 7.8%
Makefile 4.3%
Other 0.8%
 
 
 
 
 
 
Go to file
Jimmy Song 77d2459459 Merge branch 'master' of https://github.com/rootsongjc/kubernetes-handbook 2017-12-25 18:13:48 +08:00
appendix add kubernetes 1.9 GA changelog 2017-12-16 10:48:51 +08:00
cloud-native fix typo 2017-12-20 22:30:15 +08:00
concepts add seperate flannel installation doc 2017-12-19 17:57:21 +08:00
develop add kubernetes SIGs picture 2017-12-20 18:50:46 +08:00
etc 增加使用Ceph做持久化存储创建MySQL集群 2017-09-01 20:54:59 +08:00
guide fix broken link and add some description 2017-11-30 20:08:56 +08:00
images add zero downtime kubernetes upgrade tips 2017-12-21 12:34:41 +08:00
manifests add faas 2017-12-19 22:37:48 +08:00
practice Update flannel-installation.md 2017-12-23 15:50:58 +08:00
systemd change https to http 2017-12-05 23:07:19 +08:00
tools add flannel network plugin scripts 2017-12-15 19:42:57 +08:00
usecases add microservices concerns 2017-12-20 16:43:42 +08:00
.gitignore 更新网址 2017-08-22 11:42:11 +08:00
ISSUE_TEMPLATE.md add issue template 2017-11-23 18:09:55 +08:00
LICENSE merged 2017-05-18 12:50:20 +08:00
Makefile 增加Makefile 2017-06-22 12:09:47 +08:00
README.md add kubernetes cn-users slack channel 2017-12-23 22:15:42 +08:00
SUMMARY.md fix typo 2017-12-25 18:13:31 +08:00
book.json 重新整理目录结构 2017-11-15 20:42:38 +08:00
cover.jpg 使用本地图片 2017-11-15 22:21:09 +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开源的容器编排调度引擎，作为CNCF（Cloud Native Computing Foundation）最重要的组件之一，它的目标不仅仅是一个编排系统，而是提供一个规范，可以让你来描述集群的架构，定义服务的最终状态，kubernetes可以帮你将系统自动得达到和维持在这个状态。Kubernetes作为云原生应用的基石，相当于一个云操作系统，其重要性不言而喻。

本书记录了本人从零开始学习和使用Kubernetes的心路历程，着重于经验分享和总结，同时也会有相关的概念解析，希望能够帮助大家少踩坑，少走弯路，还会指引大家关于关注kubernetes生态周边，如微服务构建、DevOps、大数据应用、Service Mesh、Cloud Native等领域。

起初写作本书时，安装的所有组件、所用示例和操作等皆基于Kubernetes1.6.0 版本，同时我们也将密切关注kubernetes的版本更新，随着它的版本更新升级，本书中的kubernetes版本和示例也将随之更新。

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

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

如何使用本书

在线浏览

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

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

本地查看

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

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

访问 gitbook 可以看到下载地址，可以下载根据最新文档生成的 PDF/ePub/Mobi 格式文档（文档的注脚中注明了更新时间），同时也可以直接在 gitbook 中阅读，不过 gitbook 不太稳定打开速度较慢，建议大家直接在 https://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

需要用到的工具：calibre，phantomjs

  1. 将上述2个安装，calibre 默认安装的路径 C:\Program Files\Calibre2 为你解压路径；
  2. 并将其目录均加入到系统变量 path 中,参考:目录添加到系统变量 path 中；
  3. 在 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目录专门用来保存配置文件和文档中用到的其他相关文件；

添加文档

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

关于

贡献者列表

加入K8S🤘Cloud Native实战群

  • 微信群：扫描二维码，Jimmy Song，或直接搜索微信号jimmysong后拉您入群，请增加备注。
  • Slack：全球中文用户可以加入Kubernetes官方Slack中文频道cn-users channel