From f124e1163538d041aa0b67915c913f86e0214e1c Mon Sep 17 00:00:00 2001
From: Jimmy Song <rootsongjc@gmail.com>
Date: Thu, 1 Feb 2018 17:29:18 +0800
Subject: [PATCH] setting up a kubernetes cluster with vagrant and virtualbox

---
 SUMMARY.md                                    |  1 +
 ...-vagrant-and-virtualbox-for-development.md | 73 +++++++++++++++++++
 2 files changed, 74 insertions(+)
 create mode 100644 develop/using-vagrant-and-virtualbox-for-development.md

diff --git a/SUMMARY.md b/SUMMARY.md
index 9b04affca..b6b81abbb 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -182,6 +182,7 @@
 - [开发指南概览](develop/index.md)
 - [SIG和工作组](develop/sigs-and-working-group.md)
 - [开发环境搭建](develop/developing-environment.md)
+- [本地分布式开发环境搭建（使用Vagrant和Virtualbox）](develop/using-vagrant-and-virtualbox-for-development.md)
 - [单元测试和集成测试](develop/testing.md)
 - [client-go示例](develop/client-go-sample.md)
 - [Operator](develop/operator.md)
diff --git a/develop/using-vagrant-and-virtualbox-for-development.md b/develop/using-vagrant-and-virtualbox-for-development.md
new file mode 100644
index 000000000..7db30d357
--- /dev/null
+++ b/develop/using-vagrant-and-virtualbox-for-development.md
@@ -0,0 +1,73 @@
+# 本地分布式开发环境搭建（使用Vagrant和Virtualbox）
+
+当我们需要在本地开发时，更希望能够有一个开箱即用又可以方便定制的分布式开发环境，这样才能对Kubernetes本身和应用进行更好的测试。现在我们使用[Vagrant](https://www.vagrantup.com/)和[VirtualBox](https://www.virtualbox.org/wiki/Downloads)来创建一个这样的环境。
+
+部署时需要使用的配置文件和`vagrantfile`请见：https://github.com/rootsongjc/kubernetes-vagrant-centos-cluster
+
+## 准备环境
+
+需要准备以下软件和环境：
+
+- 8G以上内存
+- Vagrant 2.0+
+- Virtualbox 5.0 +
+- 提前下载kubernetes的安装包
+
+## 集群
+
+我们使用Vagrant和Virtualbox安装包含3个节点的kubernetes集群，其中master节点同时作为node节点。
+
+| IP           | 主机名   | 组件                                       |
+| ------------ | ----- | ---------------------------------------- |
+| 172.17.8.101 | node1 | kube-apiserver、kube-controller-manager、kube-scheduler、etcd、kubelet、docker、flannel |
+| 172.17.8.102 | node2 | kubelet、docker、flannel                   |
+| 172.17.8.103 | node3 | kubelet、docker、flannel                   |
+
+**注意**：以上的IP、主机名和组件都是固定在这些节点的，即使销毁后下次使用vagrant重建依然保持不变。
+
+## 安装的组件
+
+安装完成后的集群包含以下组件：
+
+- flannel
+- kubernetes dashboard
+- etcd（单节点）
+- kubectl
+
+## 部署
+
+确保安装好以上的准备环境后，执行下列命令启动kubernetes集群：
+
+```bash
+git clone https://github.com/rootsongjc/kubernetes-vagrant-centos-cluster.git
+cd kubernetes-vagrant-centos-cluster
+vagrant up
+```
+
+**注意**：克隆完Git仓库后，需要提前下载kubernetes的压缩包到`kubenetes-vagrant-centos-cluster`目录下，包括如下两个文件：
+
+- kubernetes-client-linux-amd64.tar.gz
+- kubernetes-server-linux-amd64.tar.gz
+
+如果是首次部署，会自动下载`centos/7`的box，这需要花费一些时间，另外每个节点还需要下载安装一系列软件包，整个过程大概需要10几分钟。
+
+## 访问kubernetes集群
+
+```bash
+vagrant ssh node1
+sudo -i
+kubectl get nodes
+```
+
+## 清理
+
+```bash
+vagrant destroy
+rm -rf .vagrant
+```
+
+## 参考
+
+- [Kubernetes handbook - jimmysong.io](https://jimmysong.io/kubernetes-handbook)
+- [duffqiu/centos-vagrant](https://github.com/duffqiu/centos-vagrant)
+- [kubernetes-vagrant-centos-cluster](https://github.com/rootsongjc/kubernetes-vagrant-centos-cluster)
\ No newline at end of file