Add the kubernetes quickstart

Author: yeasy

_images/k8s-singlenode-docker.png

@@ -5,8 +5,8 @@
 ## 架构设计
 ![](../_images/kubernetes_design.jpg)
 
-* [节点](#nodes)：一个节点是一个运行Kubernetes中的主机。
-* [容器组](#pods)：一个Pod对应于由若干容器组成的一个容器组，同个组内的容器共享一个存储卷(volume)。
+* [节点](#nodes)：一个节点是一个运行 Kubernetes 中的主机。
+* [容器组](#pods)：一个 Pod 对应于由若干容器组成的一个容器组，同个组内的容器共享一个存储卷(volume)。
 * [容器组生命周期](#pos-states)：包含所有容器状态集合，包括容器组状态类型，容器组生命周期，事件，重启策略，以及replication controllers。
 * [Replication Controllers](#replication-controllers)：主要负责指定数量的pod在同一时间一起运行。
 * [服务](#services)：一个Kubernetes服务是容器组逻辑的高级抽象，同时也对外提供访问容器组的策略。
@@ -190,4 +190,4 @@ Kubernetes校验节点可用依赖于id。在当前的版本中，有两个接
 <h3 id="labels">标签</h3>
 <h3 id="accessing_the_api">接口权限</h3>
 <h3 id="ux">web界面</h3>
-<h3 id="cli">命令行操作</h3>
+<h3 id="cli">命令行操作</h3>

kubernetes/design.md

@@ -16,4 +16,4 @@ Kubernets 目前在[github.com/GoogleCloudPlatform/kubernetes](https://github.co
 
 ### Kubernetes 能够运行在任何地方！
 
-虽然Kubernets最初是为GCE定制的，但是在后续版本中陆续增加了其他云平台的支持，以及本地数据中心的支持。
+虽然Kubernets最初是为GCE定制的，但是在后续版本中陆续增加了其他云平台的支持，以及本地数据中心的支持。

kubernetes/intro.md

@@ -0,0 +1,76 @@
+# 快速上手
+
+目前，Kubenetes 支持在多种环境下的安装，包括本地主机（Fedora）、云服务（Google GAE、AWS 等）。然而最快速体验 Kubernetes 的方式显然是本地通过 Docker 的方式来启动相关进程。
+
+下图展示了在单节点使用 Docker 快速部署一套 Kubernetes 的拓扑。
+
+![在 Docker 中启动 Kubernetes](../../_images/k8s-singlenode-docker.png)
+
+Kubernetes 依赖 Etcd 服务来维护所有主节点的状态。
+
+## 启动 Etcd 服务。
+```sh
+docker run --net=host -d gcr.io/google_containers/etcd:2.0.9 /usr/local/bin/etcd --addr=127.0.0.1:4001 --bind-addr=0.0.0.0:4001 --data-dir=/var/etcd/data
+```
+
+## 启动主节点
+启动 kubelet。
+```sh
+docker run --net=host -d -v /var/run/docker.sock:/var/run/docker.sock  gcr.io/google_containers/hyperkube:v0.17.0 /hyperkube kubelet --api_servers=http://localhost:8080 --v=2 --address=0.0.0.0 --enable_server --hostname_override=127.0.0.1 --config=/etc/kubernetes/manifests
+```
+
+## 启动服务代理
+```sh
+docker run -d --net=host --privileged gcr.io/google_containers/hyperkube:v0.17.0 /hyperkube proxy --master=http://127.0.0.1:8080 --v=2
+```
+
+## 测试状态
+在本地访问 8080 端口，应该获取到类似如下的结果：
+```sh
+$ curl 127.0.0.1:8080
+{
+  "paths": [
+    "/api",
+    "/api/v1beta1",
+    "/api/v1beta2",
+    "/api/v1beta3",
+    "/healthz",
+    "/healthz/ping",
+    "/logs/",
+    "/metrics",
+    "/static/",
+    "/swagger-ui/",
+    "/swaggerapi/",
+    "/validate",
+    "/version"
+  ]
+}
+```
+
+## 查看服务
+所有服务启动后过一会，查看本地实际运行的 Docker 容器，应该有如下几个。
+```sh
+CONTAINER ID        IMAGE                                        COMMAND                CREATED             STATUS              PORTS               NAMES
+ee054db2516c        gcr.io/google_containers/hyperkube:v0.17.0   "/hyperkube schedule   2 days ago          Up 1 days                               k8s_scheduler.509f29c9_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_e97037f5
+3b0f28de07a2        gcr.io/google_containers/hyperkube:v0.17.0   "/hyperkube apiserve   2 days ago          Up 1 days                               k8s_apiserver.245e44fa_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_6ab5c23d
+2eaa44ecdd8e        gcr.io/google_containers/hyperkube:v0.17.0   "/hyperkube controll   2 days ago          Up 1 days                               k8s_controller-manager.33f83d43_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_1a60106f
+30aa7163cbef        gcr.io/google_containers/hyperkube:v0.17.0   "/hyperkube proxy --   2 days ago          Up 1 days                               jolly_davinci
+a2f282976d91        gcr.io/google_containers/pause:0.8.0         "/pause"               2 days ago          Up 2 days                               k8s_POD.e4cc795_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_e8085b1f
+c060c52acc36        gcr.io/google_containers/hyperkube:v0.17.0   "/hyperkube kubelet    2 days ago          Up 1 days                               serene_nobel
+cc3cd263c581        gcr.io/google_containers/etcd:2.0.9          "/usr/local/bin/etcd   2 days ago          Up 1 days                               happy_turing
+```
+
+这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
+
+### 主节点服务
+* apiserver 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用；
+* scheduler 负责对资源进行调度，分配某个 pod 到某个节点上；
+* controller-manager 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。
+
+### 工作节点服务
+* kubelet 是工作节点执行操作的 agent，负责具体的容器生命周期管理，根据从数据库中获取的信息来管理容器，并上报 pod 运行状态等；
+* proxy 为 pod 上的服务提供访问的代理。
+
+### 其它服务
+* etcd 是所有状态的存储数据库；
+* `gcr.io/google_containers/pause:0.8.0` 是 Kubernetes 启动后自动 pull 下来的测试镜像。