diff --git a/_images/k8s-singlenode-docker.png b/_images/k8s-singlenode-docker.png new file mode 100644 index 0000000..5ebf812 Binary files /dev/null and b/_images/k8s-singlenode-docker.png differ diff --git a/kubernetes/design.md b/kubernetes/design.md index 63049e2..0442ca5 100644 --- a/kubernetes/design.md +++ b/kubernetes/design.md @@ -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。在当前的版本中，有两个接

标签

接口权限

web界面

-

命令行操作

\ No newline at end of file +

命令行操作

diff --git a/kubernetes/intro.md b/kubernetes/intro.md index 47af4e5..4bdb5ac 100644 --- a/kubernetes/intro.md +++ b/kubernetes/intro.md @@ -16,4 +16,4 @@ Kubernets 目前在[github.com/GoogleCloudPlatform/kubernetes](https://github.co ### Kubernetes 能够运行在任何地方！ -虽然Kubernets最初是为GCE定制的，但是在后续版本中陆续增加了其他云平台的支持，以及本地数据中心的支持。 \ No newline at end of file +虽然Kubernets最初是为GCE定制的，但是在后续版本中陆续增加了其他云平台的支持，以及本地数据中心的支持。 diff --git a/kubernetes/quickstart.md b/kubernetes/quickstart.md index e69de29..5a577f4 100644 --- a/kubernetes/quickstart.md +++ b/kubernetes/quickstart.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 下来的测试镜像。