安装序号调整，'快速指南'等文档更新

xiaofeixzy001 · Mar 17, 2018 · e51ab04 · e51ab04
1 parent 78512c6
commit e51ab04
Show file tree

Hide file tree

Showing 6 changed files with 35 additions and 109 deletions.
diff --git a/04.docker.yml → 03.docker.yml b/04.docker.yml → 03.docker.yml
diff --git a/05.kube-master.yml → 04.kube-master.yml b/05.kube-master.yml → 04.kube-master.yml
diff --git a/06.kube-node.yml → 05.kube-node.yml b/06.kube-node.yml → 05.kube-node.yml
diff --git a/07.network.yml → 06.network.yml b/07.network.yml → 06.network.yml
diff --git a/docs/00-集群规划和基础参数设定.md b/docs/00-集群规划和基础参数设定.md
@@ -3,90 +3,23 @@
 多节点高可用集群部署步骤与[AllinOne部署](quickStart.md)基本一致，增加LB 负载均衡部署步骤。
 
 ## 高可用集群所需节点配置如下：
-+ 部署节点	x1 : 运行这份 ansible 脚本的节点
-+ etcd节点	x3 : 注意etcd集群必须是1,3,5,7...奇数个节点
-+ master节点	x2 : 根据实际集群规模可以增加节点数，需要额外规划一个master VIP(虚地址)
-+ lb节点	x2 : 负载均衡节点两个，安装 haproxy+keepalived
-+ node节点	x3 : 真正应用负载的节点，根据需要增加机器配置和节点数
++ 部署节点------x1 : 运行这份 ansible 脚本的节点
++ etcd节点------x3 : 注意etcd集群必须是1,3,5,7...奇数个节点
++ master节点----x2 : 根据实际集群规模可以增加节点数，需要额外规划一个master VIP(虚地址)
++ lb节点--------x2 : 负载均衡节点两个，安装 haproxy+keepalived
++ node节点------x3 : 真正应用负载的节点，根据需要增加机器配置和节点数
 
 请注意对于多节点集群，请确保各节点时区设置一致，并使用ntp服务器同步各节点时间。
 
-生产环境使用建议一个节点只是一个角色，避免性能瓶颈问题，这里演示环境将节点绑定多个角色。项目预定义了3个例子，请修改后完成适合你的集群规划。
+生产环境使用建议一个节点只是一个角色，这里演示环境将节点绑定多个角色。项目预定义了3个例子，请修改后完成适合你的集群规划。
 
 + [单节点](../example/hosts.allinone.example)
 + [单主多节点](../example/hosts.s-master.example)
 + [多主多节点](../example/hosts.m-masters.example)
 
-## 集群所用到的参数举例如下：
-``` bash
-# ---------集群主要参数---------------
-#集群 MASTER IP, 需要负载均衡，一般为VIP地址
-MASTER_IP="192.168.1.10"
-KUBE_APISERVER="https://192.168.1.10:8443"
-
-#TLS Bootstrapping 使用的 Token，使用 head -c 16 /dev/urandom | od -An -t x | tr -d ' ' 生成
-BOOTSTRAP_TOKEN="c30302226d4b810e08731702d3890f50"
-
-# 集群网络插件，目前支持calico和flannel
-CLUSTER_NETWORK="calico"
-
-# 部分calico相关配置，更全配置可以去roles/calico/templates/calico.yaml.j2自定义
-# 设置 CALICO_IPV4POOL_IPIP=“off”,可以提高网络性能，条件限制详见 05.安装calico网络组件.md
-CALICO_IPV4POOL_IPIP="always"
-# 设置 calico-node使用的host IP，bgp邻居通过该地址建立，可手动指定端口"interface=eth0"或使用>如下自动发现
-IP_AUTODETECTION_METHOD="can-reach=223.5.5.5"
-
-# 部分flannel配置，详见roles/flannel/templates/kube-flannel.yaml.j2
-FLANNEL_BACKEND="vxlan"
-
-# 服务网段 (Service CIDR），部署前路由不可达，部署后集群内使用 IP:Port 可达
-SERVICE_CIDR="10.68.0.0/16"
-
-# POD 网段 (Cluster CIDR），部署前路由不可达，**部署后**路由可达
-CLUSTER_CIDR="172.20.0.0/16"
-
-# 服务端口范围 (NodePort Range)
-NODE_PORT_RANGE="20000-40000"
-
-# kubernetes 服务 IP (预分配，一般是 SERVICE_CIDR 中第一个IP)
-CLUSTER_KUBERNETES_SVC_IP="10.68.0.1"
-
-# 集群 DNS 服务 IP (从 SERVICE_CIDR 中预分配)
-CLUSTER_DNS_SVC_IP="10.68.0.2"
-
-# 集群 DNS 域名
-CLUSTER_DNS_DOMAIN="cluster.local."
-
-# etcd 集群间通信的IP和端口, **根据实际 etcd 集群成员设置**
-ETCD_NODES="etcd1=https://192.168.1.1:2380,etcd2=https://192.168.1.2:2380,etcd3=https://192.168.1.3:2380"
-
-# etcd 集群服务地址列表, **根据实际 etcd 集群成员设置**
-ETCD_ENDPOINTS="https://192.168.1.1:2379,https://192.168.1.2:2379,https://192.168.1.3:2379"
-
-# 集群basic auth 使用的用户名和密码
-BASIC_AUTH_USER="admin"
-BASIC_AUTH_PASS="test1234"
-
-# ---------附加参数--------------------
-#默认二进制文件目录
-bin_dir="/root/local/bin"
-
-#证书目录
-ca_dir="/etc/kubernetes/ssl"
-
-#部署目录，即 ansible 工作目录，建议不要修改
-base_dir="/etc/ansible"
-
-#私有仓库 harbor服务器 (域名或者IP)
-#HARBOR_IP="192.168.1.8"
-#HARBOR_DOMAIN="harbor.yourdomain.com"
-```
-
-+ 请事先规划好使用何种网络插件(calico flannel)，并配置对应网络插件的参数
-
 ## 部署步骤
 
-按照[多主多节点](../example/hosts.m-masters.example)示例的节点配置，至少准备4台虚机，测试搭建一个多主高可用集群。
+按照[多主多节点](../example/hosts.m-masters.example)示例的节点配置，准备4台虚机，测试搭建一个多主高可用集群。
 
 ### 1.基础系统配置
 
@@ -101,8 +34,6 @@ Ubuntu 16.04 请执行以下脚本:
 ``` bash
 # 文档中脚本默认均以root用户执行
 apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
-# 删除不要的默认安装
-apt-get purge ufw lxd lxd-client lxcfs lxc-common
 # 安装python2
 apt-get install python2.7
 # Ubuntu16.04可能需要配置以下软连接
@@ -115,8 +46,6 @@ CentOS 7 请执行以下脚本：
 # 安装 epel 源并更新
 yum install epel-release -y
 yum update
-# 删除不要的默认安装
-yum erase firewalld firewalld-filesystem python-firewall -y
 # 安装python
 yum install python -y
 ```
@@ -145,10 +74,10 @@ ssh-copy-id $IPs #$IPs为所有节点地址包括自身，按照提示输入yes
 # 下载项目文件
 git clone https://github.com/gjmzj/kubeasz.git
 mv kubeasz /etc/ansible
-# 下载已打包好的binaries，并且解压缩到/etc/ansible/bin目录
-# 国内请从我分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA 
+# 下载已打包好的binaries，解压到/etc/ansible/bin目录
+# 国内请从百度云链接下载 https://pan.baidu.com/s/1c4RFaA 
 # 如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包到 ./down目录，并执行download.sh
-tar zxvf k8s.191.tar.gz
+tar zxvf k8s.193.tar.gz
 mv bin/* /etc/ansible/bin
 cd /etc/ansible
 cp example/hosts.m-masters.example hosts
@@ -181,17 +110,18 @@ ansible all -m ping
     "ping": "pong"
 }
 ```
-+ 开始安装集群，请阅读每步安装讲解后执行分步安装
++ 开始集群安装，如果你对集群安装流程不熟悉，请阅读分步安装讲解后一步一步安装，并对每步都进行验证
 
 ``` bash
-#ansible-playbook 01.prepare.yml
-#ansible-playbook 02.etcd.yml
-#ansible-playbook 03.kubectl.yml
-#ansible-playbook 04.docker.yml
-#ansible-playbook 05.kube-master.yml
-#ansible-playbook 06.kube-node.yml
-#ansible-playbook 07.calico.yml 或者 ansible-playbook 07.flannel.yml 只能选择一种网络插件
-#ansible-playbook 90.setup.yml # 一步安装
+# 分步安装
+ansible-playbook 01.prepare.yml
+ansible-playbook 02.etcd.yml
+ansible-playbook 03.docker.yml
+ansible-playbook 04.kube-master.yml
+ansible-playbook 05.kube-node.yml
+ansible-playbook 06.network.yml
+# 一步安装
+ansible-playbook 90.setup.yml
 ```
 
 [前一篇](quickStart.md) -- [后一篇](01-创建CA证书和环境配置.md)
diff --git a/docs/quickStart.md b/docs/quickStart.md
@@ -1,6 +1,6 @@
 ## 快速指南
 
-以下为基于Ubuntu 16.04/CentOS 7.4 快速体验k8s集群的测试、开发环境--AllinOne部署，觉得比官方的minikube方便、简单很多。
+以下为快速体验k8s集群的测试、开发环境--allinone部署，国内环境下觉得比官方的minikube方便、简单很多。
 
 ### 1.基础系统配置
 
@@ -15,8 +15,6 @@ Ubuntu 16.04 请执行以下脚本:
 ``` bash
 # 文档中脚本默认均以root用户执行
 apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
-# 删除不要的默认安装
-apt-get purge ufw lxd lxd-client lxcfs lxc-common
 # 安装依赖工具
 apt-get install python2.7 git python-pip
 # Ubuntu16.04可能需要配置以下软连接
@@ -29,8 +27,6 @@ CentOS 7 请执行以下脚本：
 # 安装 epel 源并更新
 yum install epel-release -y
 yum update
-# 删除不要的默认安装
-yum erase firewalld firewalld-filesystem python-firewall -y
 # 安装依赖工具
 yum install git python python-pip -y
 ```
@@ -50,26 +46,26 @@ ssh-copy-id $IP #$IP为本虚机地址，按照提示输入yes 和root密码
 ``` bash
 git clone https://github.com/gjmzj/kubeasz.git
 mv kubeasz /etc/ansible
-# 下载已打包好的binaries，并且解压缩到/etc/ansible/bin目录
+# 下载已打包好的binaries，解压到/etc/ansible/bin目录
 # 国内请从分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA
 # 如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包到 ./down目录，并执行download.sh
 tar zxvf k8s.193.tar.gz
 mv bin/* /etc/ansible/bin
 # 配置ansible的hosts文件
 cd /etc/ansible
 cp example/hosts.allinone.example hosts
-然后根据实际情况修改此hosts文件，所有节点都是本虚机IP
-# 采用一步安装或者分步安装
-ansible-playbook 90.setup.yml # 一步安装
-#ansible-playbook 01.prepare.yml
-#ansible-playbook 02.etcd.yml
-#ansible-playbook 03.kubectl.yml
-#ansible-playbook 04.docker.yml
-#ansible-playbook 05.kube-master.yml
-#ansible-playbook 06.kube-node.yml
-# 网络只可选择calico flannel一种安装
-#ansible-playbook 07.calico.yml 
-#ansible-playbook 07.flannel.yml
+# 然后根据实际情况修改此hosts文件，所有节点都是本虚机IP
+# 开始集群安装，如果你对集群安装流程不熟悉，请阅读分步安装讲解后一步一步安装，并对每步都
+进行验证
+# 分步安装
+ansible-playbook 01.prepare.yml
+ansible-playbook 02.etcd.yml
+ansible-playbook 03.docker.yml
+ansible-playbook 04.kube-master.yml
+ansible-playbook 05.kube-node.yml
+ansible-playbook 06.network.yml
+# 一步安装
+#ansible-playbook 90.setup.yml
 ```
 如果执行成功，k8s集群就安装好了。详细分步讲解请查看项目目录 `/docs` 下相关文档
 
@@ -92,7 +88,7 @@ kubectl create -f /etc/ansible/manifests/heapster
 # 安装dashboard
 kubectl create -f /etc/ansible/manifests/dashboard
 ```
-+ 更新后`dashboard`已经默认关闭非安全端口访问，请使用`https://xx.xx.xx.xx:6443/api/v1/namespaces/kube-system/services/kubernetes-dashboard/proxy`访问，并用默认用户 `admin:test1234` 登陆，更多内容请查阅[dashboard文档](guide/dashboard.md)
++ 登陆 `dashboard`可以查看和管理集群，更多内容请查阅[dashboard文档](guide/dashboard.md)
 
 ### 7.清理集群