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
122 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 728ca70c79 添加如何贡献说明 2017-05-19 10:54:57 +08:00
addons Format files 2017-05-14 19:39:33 +08:00
appendix 重新组织部分文件 2017-05-18 16:16:22 +08:00
apps Format files 2017-05-14 19:39:33 +08:00
architecture 重构文章目录 2017-05-18 15:24:07 +08:00
cluster Format files 2017-05-14 19:39:33 +08:00
cluster-federation Format files 2017-05-14 19:39:33 +08:00
components Format files 2017-05-14 19:39:33 +08:00
debugging Format files 2017-05-14 19:39:33 +08:00
deploy 重新组织部分文件 2017-05-18 16:16:22 +08:00
dev small update 2017-05-15 20:24:00 +08:00
etc 增加keepalived配置文件 2017-05-09 14:07:11 +08:00
ha Format files 2017-05-14 19:39:33 +08:00
images 重新组织部分文件 2017-05-18 16:16:22 +08:00
introduction Format files 2017-05-14 19:39:33 +08:00
manifests 修改应用日志收集为filebeat 2017-05-17 17:04:46 +08:00
monitor Format files 2017-05-14 19:39:33 +08:00
network 重构文章目录 2017-05-18 15:24:07 +08:00
ops 修复图片链接错误 2017-05-18 17:20:59 +08:00
plugins Format files 2017-05-14 19:39:33 +08:00
security 重构文章目录 2017-05-18 15:24:07 +08:00
service-discovery-lb 重构文章目录 2017-05-18 15:24:07 +08:00
storage 重构文章目录 2017-05-18 15:24:07 +08:00
systemd 修改docker的service配置，增加环境变量 2017-04-27 22:20:18 +08:00
.gitignore Initial commit 2017-05-14 18:50:48 +08:00
LICENSE merged 2017-05-18 12:50:20 +08:00
Makefile Add a makefile 2017-05-15 09:07:11 +08:00
README.md 添加如何贡献说明 2017-05-19 10:54:57 +08:00
SUMMARY.md 重新组织部分文件 2017-05-18 16:16:22 +08:00
book.json merged 2017-05-18 12:50:20 +08:00
cover.jpg 重新组织部分文件 2017-05-18 16:16:22 +08:00
ecosystem.md 重新组织部分文件 2017-05-18 16:16:22 +08:00
issues.md 增加参考链接 2017-05-12 18:19:09 +08:00
pm-template.latex 增加latex的模版 2017-04-27 11:08:31 +08:00
reference.md Add initial contents 2017-05-14 19:16:51 +08:00

README.md

Kubernetes Handbook

Kubernetes是谷歌开源的容器集群管理系统，是Google多年大规模容器管理技术Borg的开源版本，也是CNCF最重要的组件之一，主要功能包括：

  • 基于容器的应用部署、维护和滚动升级
  • 负载均衡和服务发现
  • 跨机器和跨地区的集群调度
  • 自动伸缩
  • 无状态服务和有状态服务
  • 广泛的Volume支持
  • 插件机制保证扩展性

Kubernetes发展非常迅速，已经成为容器编排领域的领导者。Kubernetes的中文资料也非常丰富，但系统化和紧跟社区更新的则就比较少见了。《Kubernetes指南》开源电子书旨在整理平时在开发和使用Kubernetes时的参考指南和实践心得，更是为了形成一个系统化的参考指南以方便查阅。欢迎大家关注，更欢迎大家一起添加更多更好的内容。

本书所有的组件安装、示例和操作等都基于Kubernetes1.6.0版本。

文章同步更新到gitbook，方便大家浏览和下载PDF。

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

文章目录

如何阅读

在线浏览

访问gitbook：https://www.gitbook.com/book/rootsongjc/kubernetes-handbook/

文中涉及的配置文件和代码链接在gitbook中会无法打开，请下载github源码后，在MarkDown编辑器中打开，点击链接将跳转到你的本地目录，推荐使用typora。

本地查看

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

生成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,phantomjs为你解压路径
  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目录下，原则上文章中用到的图片都保存在本地；
  • 所有的文档的文件名使用英文命名，可以包含数字和中划线，不要使用下划线，为了生成网站时，分享URL时候的方便，中文会重新编码；
  • etc、manifests目录专门用来保存配置文件；

添加文档

  1. 在该文章相关主题的目录下创建文档；
  2. 在SUMMARY.md中在相应的章节下添加文章链接；
  3. 在文章相应的主题的头文档，即以该主题命名的文档中添加链接；
  4. 执行gitbook server测试是否保存，然后访问 http://localhost:4000 查看该文档是否出现在相应主题的目录下；
  5. 对该文档有卓越贡献的人将被加入到贡献者名单中；

贡献者

Jimmy Song

feiskyer