kubernetes-handbook/README.md

95 lines
3.7 KiB
Markdown
Raw Normal View History

2017-04-14 17:39:40 +08:00
# Kubernetes Handbook
2017-05-20 21:03:25 +08:00
[Kubernetes](http://kubernetes.io)是Google基于[Borg](https://research.google.com/pubs/pub43438.html)开源的容器编排调度引擎,作为[CNCF](http://cncf.io)Cloud Native Computing Foundation最重要的组件之一它的目标不仅仅是一个编排系统而是提供一个规范可以让你来描述集群的架构定义服务的最终状态它将自动得将系统达到和维持在这个状态。
2017-05-18 15:24:07 +08:00
2017-05-20 21:03:25 +08:00
本书记录了本人从零开始学习和使用Kubernetes的心路历程着重于经验分享和总结同时也会有相关的概念解析希望能够帮助大家少踩坑少走弯路。
2017-05-18 15:24:07 +08:00
2017-05-20 21:03:25 +08:00
在写作本书时,安装的所有组件、所用示例和操作等皆基于**Kubernetes1.6.0**版本。
2017-04-14 17:39:40 +08:00
2017-05-20 21:03:25 +08:00
[文章目录](SUMMARY.md)
2017-04-14 19:27:08 +08:00
2017-04-15 07:59:51 +08:00
GitHub地址https://github.com/rootsongjc/kubernetes-handbook
2017-05-20 21:03:25 +08:00
Gitbook在线浏览https://www.gitbook.com/book/rootsongjc/kubernetes-handbook/
2017-04-14 19:08:11 +08:00
2017-05-20 21:03:25 +08:00
## 如何使用本书
2017-04-14 19:27:08 +08:00
**在线浏览**
2017-05-20 21:03:25 +08:00
访问[gitbook](https://www.gitbook.com/book/rootsongjc/kubernetes-handbook/)
2017-04-14 19:27:08 +08:00
2017-05-18 17:48:28 +08:00
文中涉及的配置文件和代码链接在gitbook中会无法打开请下载github源码后在MarkDown编辑器中打开点击链接将跳转到你的本地目录推荐使用[typora](www.typorai.o)。
2017-05-18 16:16:22 +08:00
2017-04-14 19:27:08 +08:00
**本地查看**
1. 将代码克隆到本地
2. 安装gitbook[Setup and Installation of GitBook](https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md)
3. 执行gitbook serve
4. 在浏览器中访问http://localhost:4000
2017-04-27 11:08:45 +08:00
5. 生成的文档在`_book`目录下
**生成pdf**
2017-05-11 18:22:00 +08:00
[下载Calibre](http://calibre-ebook.com/download)
2017-05-18 16:16:22 +08:00
- **On Mac**
2017-05-11 18:22:00 +08:00
在Mac下安装后使用该命令创建链接
```
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
```
在该项目目录下执行以下命令生成`kubernetes-handbook.pdf`文档。
```
gitbook pdf . ./kubernetes-handbook.pdf
```
2017-05-18 16:16:22 +08:00
- **On Windows**
2017-05-20 21:03:25 +08:00
需要用到的工具:[calibre](http://calibre-ebook.com/)[phantomjs](http://phantomjs.org/download.html)
2017-05-20 21:03:25 +08:00
1. 将上述2个安装calibre默认安装的路径`C:\Program Files\Calibre2`为你解压路径;
2. 并将其目录均加入到系统变量path中,参考:目录添加到系统变量path中
3. 在cmd打开你需要转pdf的文件夹,输入`gitbook pdf`即可;
2017-05-11 18:22:00 +08:00
**生成单个章节的pdf**
2017-04-27 11:08:45 +08:00
使用`pandoc`和`latex`来生成pdf格式文档。
```shell
pandoc --latex-engine=xelatex --template=pm-template input.md -o output.pdf
```
2017-04-14 19:27:08 +08:00
2017-05-19 10:54:57 +08:00
## 如何贡献
### 提issue
如果你发现文档中的错误,或者有好的建议,不要犹豫,欢迎[提交issue](https://github.com/rootsongjc/kubernetes-handbook/issues/new)。
### 发起Pull Request
当你发现文章中明确的错误或者逻辑问题在你自己的fork的分支中创建一个新的branch修改错误push到你的branch然后在[提交issue](https://github.com/rootsongjc/kubernetes-handbook/issues/new)后直接发起Pull Request。
### 贡献文档
2017-05-20 21:03:25 +08:00
#### 文档的组织规则
2017-05-19 10:54:57 +08:00
- 如果要创建一个大的主题就在最顶层创建一个目录;
2017-05-20 21:17:28 +08:00
- 全书五大主题,每个主题一个目录,其下不再设二级目录;
2017-05-19 10:54:57 +08:00
- 所有的图片都放在最顶层的`images`目录下,原则上文章中用到的图片都保存在本地;
2017-05-20 21:03:25 +08:00
- 所有的文档的文件名使用英文命名,可以包含数字和中划线;
- `etc`、`manifests`目录专门用来保存配置文件和文档中用到的其他相关文件;
2017-05-19 10:54:57 +08:00
2017-05-20 21:03:25 +08:00
#### 添加文档
2017-05-19 10:54:57 +08:00
1. 在该文章相关主题的目录下创建文档;
2. 在`SUMMARY.md`中在相应的章节下添加文章链接;
2017-05-20 21:17:28 +08:00
3. 执行`gitbook server`测试是否报错,访问 http://localhost:4000 查看该文档是否出现在相应主题的目录下;
4. 提交PR
2017-05-19 10:54:57 +08:00
2017-05-20 21:03:25 +08:00
## 关于
2017-04-14 17:39:40 +08:00
2017-04-15 07:59:51 +08:00
[Jimmy Song](http://rootsongjc.github.io/about)