docs: fix deployment documents, issue #4

README.md

@@ -32,9 +32,12 @@
 ## Getting Started
 
 > 容器管理平台是蓝鲸智云社区版V5.1以上推出的产品，后台服务可以独立部署与使用。如果需要SaaS的支持，则需要与蓝鲸社区版软件配合使用。
+
 > 目前社区版5.1在灰度内测中，若想体验，请填写问卷留下邮箱等信息，蓝鲸将在1-2个工作日通过邮箱方式，交付软件。感谢对蓝鲸的支持与理解。
 > 问卷链接：[https://wj.qq.com/s2/3830461/a8bc/](https://wj.qq.com/s2/3830461/a8bc/)
 
+> 蓝鲸社区版5.1完全开放下载时间为2019-07-05
+
 * [下载与编译](docs/install/source_compile.md)
 * [安装部署](docs/install/deploy-guide.md)
 * [API使用说明](./docs/apidoc/api.md)

docs/install/Deploy_BCS_in_K8S_HA_Cluster.md

@@ -0,0 +1,108 @@
+# BCS高可用Kubernetes集群部署
+
+部署BCS管理的高可用Kubernetes集群有2种方式：
+
+- **蓝鲸社区版(BCS增值包)**：使用[容器服务控制台](https://docs.bk.tencent.com/bcs/Container/QuickStart.html)一键创建Kubernetes集群，Master节点推荐3或5台，集群创建成功后，可以进入集群节点列表，为集群增加节点
+
+- **手动部署**：
+  - 参考社区的方案搭建
+    - [《和我一步步部署 kubernetes 集群》](https://github.com/opsnull/follow-me-install-kubernetes-cluster)
+    - 使用[Kubespray](https://kubernetes.io/docs/setup/custom-cloud/kubespray/)
+    - 使用[kubeasz](https://github.com/easzlab/kubeasz)(中文)
+  - 搭建完Kubernetes集群后，参考本文档指引部署BCS组件
+
+## 目标机器环境准备
+
+### 硬件
+
+| 资源      | 配置    |
+| -------- | ------- |
+| CPU      | 4核     |
+| Mem      | 8GB     |
+| Disk     | >= 50GB |
+
+>注：Slave节点可根据业务规模增加机器配置 
+
+### 操作系统
+
+CentOS 7及以上系统，推荐CentOS 7.4
+
+> 注：
+>
+> 1. 集群网络模式使用Overlay网络模式，需要有NAT模块(iptable_nat)
+>
+> 2. CRI推荐使用Docker，storage-dirver推荐使用overlay2，CentOS内核版本需要在3.10.0-693及以上支持Overlay2
+
+###  网络
+
+- 放行集群层到服务层的机器所有网络策略
+- 放行集群层机器间的所有网络策略
+
+<!-- To-Do: 严格的网络策略 -->
+
+## 部署BCS K8S组件
+
+在K8S集群中部署如下组件，即能将K8S纳入BCS管理
+- bcs-kube-agent:
+- bcs-k8s-watch:
+
+### bcs-kube-agent
+
+#### 创建集群相关信息
+
+- 参考[BCS K8S API文档](https://github.com/Tencent/bk-bcs/blob/master/docs/apidoc/k8s.md)
+  - 创建用户
+  - 创建`user_token`
+  - 创建集群
+  - 创建`register_token`
+
+#### 制作镜像
+
+```bash
+cd $GOPATH/src/bk-bcs/build/bcs.${VERSION}/bin/bcs-kube-agent
+docker build .
+```
+
+将build后的镜像推送至Docker仓库或者导入至要K8S Master机器本地
+
+#### 修改bcs-kube-agent配置文件
+
+```bash
+cd $GOPATH/src/bk-bcs/bcs-k8s/bcs-kube-agent/install
+```
+
+- 修改`kube-agent.yaml`配置文件
+  - `image`字段：填写镜像的`<REPOSITORY>:<TAG>`
+  - `bke-address`字段：填写创建的Cluster_ID
+
+- 修改`kube-agent-secret.yml`文件
+  - `token`字段： 将集群`register_token`base64 encoding
+  - `bke-cert`字段：将部署BCS Service层组件时生成的CA证书base64 encoding
+
+#### 部署bcs-kube-agent
+
+在K8S集群中执行
+
+```bash
+kubectl create -f kube-agent-secret.yml
+kubectl apply -f kube-agent.yaml
+```
+
+### bcs-k8s-watch
+
+#### 制作镜像
+
+```bash
+cd $GOPATH/src/bk-bcs/build/bcs.${VERSION}/bin/bcs-kube-agent
+docker build .
+```
+
+将build后的镜像推送至Docker仓库或者导入至要K8S Master机器本地
+
+#### 修改bcs-k8s-watch配置文件
+
+参考[bcs-watch部署文档](https://github.com/Tencent/bk-bcs/blob/master/docs/features/k8s-watch/k8s-watch%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3.md)修改配置文件
+
+#### 部署bcs-k8s-watch
+
+将`bcs-datawatch.yaml`放置于每台K8S master机器的manifests目录，默认`/etc/kubernetes/manifests`，以static pod方式运行`bcs-k8s-watch`

docs/install/Deploy_BCS_in_Mesos_HA_Cluster.md

@@ -0,0 +1,62 @@
+# BCS高可用Mesos集群部署
+
+部署BCS管理的Mesos高可用集群有2种方式：
+
+- **蓝鲸社区版(BCS增值包)**：使用[容器服务控制台](https://docs.bk.tencent.com/bcs/Container/QuickStart.html)一键创建Mesos集群，Master节点推荐3或5台，集群创建成功后，可以进入集群节点列表，为集群增加节点
+
+- **手动部署**： 参考本文档指引部署BCS高可用Mesos集群
+
+## 目标机器环境准备
+
+### 硬件
+
+| 资源      | 配置    |
+| -------- | ------- |
+| CPU      | 4核     |
+| Mem      | 8GB     |
+| Disk     | >= 50GB |
+
+>注：Slave节点可根据业务规模增加机器配置 
+
+### 操作系统
+
+CentOS 7及以上系统（内核版本3.10.0-693及以上），推荐CentOS 7.4
+
+> 注：集群网络模式使用Overlay网络模式，需要有NAT模块(iptable_nat)
+
+### 网络
+
+- 放行集群层到服务层的机器所有网络策略
+- 放行集群层机器间的所有网络策略
+
+<!-- To-Do: 严格的网络策略 -->
+
+## 组件说明
+
+- 开源组件依赖
+  - Master层
+    - zookeeper(>=3.4.8): 集群信息存储
+    - mesos(>=1.1.0)
+    - etcd(推荐>=3.3.10): Overlay网络模式使用，为flannel维护网络的分配情况
+  - Node层
+    - docker(推荐使用18.09.X)
+    - flannel: 通过给每台宿主机分配一个子网的方式为容器提供虚拟网络，它基于Linux TUN/TAP，使用UDP封装IP包来创建Overlay网络
+- BCS组件
+  - Master层
+    - bcs-mesos-driver
+    - bcs-mesos-watch
+    - bcs-scheduler
+    - bcs-check
+    - bcs-dns
+    - bcs-health-slave
+  - Node层
+    - bcs-container-executor
+
+## 部署Mesos集群
+
+高可用部署思路：确保存储组件zookeeper、etcd高可用，Mesos Master高可用，Master层的BCS组件部署2台以上
+
+- zookeeper高可用[部署指引](http://zookeeper.apache.org/doc/r3.4.10/zookeeperStarted.html)
+- etcd高可用[部署指引](https://etcd.io/docs/v3.3.12/op-guide/clustering/)
+- mesos master高可用[部署指引](http://mesos.apache.org/documentation/latest/high-availability/)
+- 部署BCS组件参考文档[bcs项目单机部署流程(mesos)](./mesos-deploy-in-single-guide.md): Master层的BCS组件部署2台以上