mirror of https://github.com/easzlab/kubeasz.git
198 lines
6.7 KiB
Markdown
198 lines
6.7 KiB
Markdown
## 00-集群规划和基础参数设定.md
|
||
|
||
多节点高可用集群部署步骤与[AllinOne部署](quickStart.md)基本一致，增加LB 负载均衡部署步骤。
|
||
|
||
## 高可用集群所需节点配置如下：
|
||
+ 部署节点 x1 : 运行这份 ansible 脚本的节点
|
||
+ etcd节点 x3 : 注意etcd集群必须是1,3,5,7...奇数个节点
|
||
+ master节点 x2 : 根据实际集群规模可以增加节点数，需要额外规划一个master VIP(虚地址)
|
||
+ lb节点 x2 : 负载均衡节点两个，安装 haproxy+keepalived
|
||
+ node节点 x3 : 真正应用负载的节点，根据需要增加机器配置和节点数
|
||
|
||
请注意对于多节点集群，请确保各节点时区设置一致，并使用ntp服务器同步各节点时间。
|
||
|
||
生产环境使用建议一个节点只是一个角色，避免性能瓶颈问题，这里演示环境将节点绑定多个角色。项目预定义了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台虚机，测试搭建一个多主高可用集群。
|
||
|
||
### 1.基础系统配置
|
||
|
||
+ 推荐内存2G/硬盘20G以上
|
||
+ 最小化安装`Ubuntu 16.04 server`或者`CentOS 7 Minimal`
|
||
+ 配置基础网络、更新源、SSH登陆等
|
||
|
||
### 2.在每个节点安装依赖工具
|
||
|
||
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可能需要配置以下软连接
|
||
ln -s /usr/bin/python2.7 /usr/bin/python
|
||
```
|
||
CentOS 7 请执行以下脚本：
|
||
|
||
``` bash
|
||
# 文档中脚本默认均以root用户执行
|
||
# 安装 epel 源并更新
|
||
yum install epel-release -y
|
||
yum update
|
||
# 删除不要的默认安装
|
||
yum erase firewalld firewalld-filesystem python-firewall -y
|
||
# 安装python
|
||
yum install python -y
|
||
```
|
||
### 3.在deploy节点安装及准备ansible
|
||
|
||
``` bash
|
||
# Ubuntu 16.04
|
||
apt-get install git python-pip -y
|
||
# CentOS 7
|
||
yum install git python-pip -y
|
||
# pip安装ansible(国内如果安装太慢可以直接用pip阿里云加速)
|
||
#pip install pip --upgrade
|
||
#pip install ansible
|
||
pip install pip --upgrade -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||
pip install --no-cache-dir ansible -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
|
||
```
|
||
### 4.在deploy节点配置免密码登陆
|
||
|
||
``` bash
|
||
ssh-keygen -t rsa -b 2048 回车 回车 回车
|
||
ssh-copy-id $IPs #$IPs为所有节点地址包括自身，按照提示输入yes 和root密码
|
||
```
|
||
### 5.在deploy节点编排k8s安装
|
||
|
||
``` bash
|
||
# 下载项目文件
|
||
git clone https://github.com/gjmzj/kubeasz.git
|
||
mv kubeasz /etc/ansible
|
||
# 下载已打包好的binaries，并且解压缩到/etc/ansible/bin目录
|
||
# 国内请从我分享的百度云链接下载 https://pan.baidu.com/s/1c4RFaA
|
||
# 如果你有合适网络环境也可以按照/down/download.sh自行从官网下载各种tar包到 ./down目录，并执行download.sh
|
||
tar zxvf k8s.191.tar.gz
|
||
mv bin/* /etc/ansible/bin
|
||
cd /etc/ansible
|
||
cp example/hosts.m-masters.example hosts
|
||
# 根据上文实际规划修改此hosts文件
|
||
vi hosts
|
||
```
|
||
+ 验证ansible安装
|
||
|
||
在deploy 节点使用如下命令
|
||
|
||
``` bash
|
||
ansible all -m ping
|
||
```
|
||
如果配置正确可以看到类似输出：
|
||
|
||
``` text
|
||
192.168.1.42 | SUCCESS => {
|
||
"changed": false,
|
||
"failed": false,
|
||
"ping": "pong"
|
||
}
|
||
192.168.1.43 | SUCCESS => {
|
||
"changed": false,
|
||
"failed": false,
|
||
"ping": "pong"
|
||
}
|
||
192.168.1.44 | SUCCESS => {
|
||
"changed": false,
|
||
"failed": false,
|
||
"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 # 一步安装
|
||
```
|
||
|
||
[前一篇](quickStart.md) -- [后一篇](01-创建CA证书和环境配置.md)
|