概覽
下面的指引將高速你如何通過Docker創建一個單機、單節點的Kubernetes集群。
下圖是最終的結果:
先決條件
1. 你必須擁有一台安裝有Docker的機器。
2. 你的內核必須支持 memory and swap accounting 。確認你的linux內核開啟了如下配置:
CONFIG_RESOURCE_COUNTERS=y CONFIG_MEMCG=y CONFIG_MEMCG_SWAP=y CONFIG_MEMCG_SWAP_ENABLED=y CONFIG_MEMCG_KMEM=y
3. 以命令行參數方式,在內核啟動時開啟 memory and swap accounting 選項:
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"
注意:以上只適用於GRUB2。通過查看/proc/cmdline可以確認命令行參數是否已經成功
傳給內核:
$cat /proc/cmdline BOOT_IMAGE=/boot/vmlinuz-3.18.4-aufs root=/dev/sda5 ro cgroup_enable=memory swapaccount=1
第一步:運行Etcd
docker run --net=host -d gcr.io/google_containers/etcd:2.0.12 /usr/local/bin/etcd --addr=127.0.0.1:4001 --bind-addr=0.0.0.0:4001 --data-dir=/var/etcd/data
第二步:啟動master
docker run \
--volume=/:/rootfs:ro \ --volume=/sys:/sys:ro \ --volume=/dev:/dev \ --volume=/var/lib/docker/:/var/lib/docker:ro \ --volume=/var/lib/kubelet/:/var/lib/kubelet:rw \ --volume=/var/run:/var/run:rw \ --net=host \ --pid=host \ --privileged=true \ -d \ gcr.io/google_containers/hyperkube:v1.0.1 \ /hyperkube kubelet --containerized --hostname-override="127.0.0.1" --address="0.0.0.0" --api-servers=http://localhost:8080 --config=/etc/kubernetes/manifests
這一步實際上運行的是 kubelet ,並啟動了一個包含其他master組件的[pod](../userguide/pods.md)。
第三步:運行service proxy
docker run -d --net=host --privileged gcr.io/google_containers/hyperkube:v1.0.1 /hyperkube proxy --master=http://127.0.0.1:8080 --v=2
測試
此時你應該已經運行起了一個Kubernetes集群。你可以下載kubectl二進制程序進行測試:
(OS X) (linux)
注意: 再OS/X上你需要通過ssh設置端口轉發:
boot2docker ssh -L8080:localhost:8080
列出集群中的節點:
kubectl get nodes
應該輸出以下內容:
NAME LABELS STATUS
127.0.0.1 Ready
如果你運行了不同的Kubernetes集群,你可能需要指定 -s http://localhost:8080 選項來訪問本地集群。
運行一個應用
kubectl -s http://localhost:8080 run nginx --image=nginx --port=80
運行 docker ps 你應該就能看到nginx在運行。下載鏡像可能需要等待幾分鍾。
暴露為service
kubectl expose rc nginx --port=80
運行以下命令來獲取剛才創建的service的IP地址。有兩個IP,第一個是內部的
(CLUSTER_IP),第二個是外部的負載均衡IP。
kubectl get svc nginx
同樣你也可以通過運行以下命令只獲取第一個IP(CLUSTER_IP):
kubectl get svc nginx --template={{.spec.clusterIP}}
通過第一個IP(CLUSTER_IP)訪問服務:
curl <insert-cluster-ip-here>
注意如果再OSX上需要再boot2docker虛擬機上運行curl。
關於關閉集群的說明
上面的各種容器都是運行在 kubelet 程序的管理下,它會保證容器一直運行,甚至容器意外退出時也不例外。所以,如果想關閉集群,你需要首先關閉 kubelet 容器,再關閉其他。
可以使用 docker kill $(docker ps -aq) 。注意這樣會關閉Docker下運行的所有容器,請謹慎使用。