Kubernetes集群部署
预备知识
如果你不知道以下是做什么的,那么请参考下面链接(包括但不限于)进行学习:
前置要求与约定
集群会使用到的端口号。
各服务器时间与时区需一致,集群内服务器间时间差值不能大于1秒。
文档以 4 个 CentOS 7.4 系统服务器安装高可用 Kubernetes 集群进行讲解。
按照本文档安装 Kubernetes 集群时,Ansible 脚本会将服务器上防火墙关闭,请使用安全组进行网络权限控制。
Master(s) 服务器为 Kubernetes 控制服务器;Worker(s) 服务器为 Kubernetes 运算服务器;Etcd 服务器为组建Etcd 集群的服务器,Etcd 官方建议 Etcd 集群服务器个数为奇数个(比如1、3、5)以防止脑裂。
为安全考虑按本教程安装的 Kubernetes 集群只会在 Master(s) 服务器上配置 kubectl 命令所需 kubeconfig,故 Worker(s) 服务器默认是无法使用 kubectl 命令的。
集群安装示例
环境准备
# 安装 git 命令行
sudo yum install git -y
# 克隆本项目代码
git clone https://github.com/choerodon/kubeadm-ha.git
# 进入项目目录
cd kubeadm-ha
# 安装 ansible 环境
sudo ./install-ansible.sh
配置 ansible inventory 文件
- 项目
example
文件夹下提供了 6 个 ansible inventory 示例文件,请按需求进行选择并修改。 - 拷贝项目下的
example/hosts.m-master.ip.ini
文件至项目根目录下,命名为inventory.ini
,修改各服务器的 IP 地址、用户名、密码,并维护好各服务器与角色的关系。
请使用服务器内网 IP 作为 ansible 目标服务器 IP,请勿使用服务器公网 IP。该用户必须是具有 root 权限的用户,但并非要求一定是 root 用户,其他具有 root 权限的用户也可以。
克隆下来的本项目文件与 inventory.ini 文件很重要,涉及到后期的集群运维工作,请一定妥善保管。
; 将所有节点的信息在这里填写
; 第一个字段 为节点内网IP,部署完成后为 kubernetes 节点 nodeName
; 第二个字段 ansible_port 为节点 sshd 监听端口
; 第三个字段 ansible_user 为节点远程登录用户名
; 第四个字段 ansible_ssh_pass 为节点远程登录用户密码
[all]
192.168.56.11 ansible_port=22 ansible_user="vagrant" ansible_ssh_pass="vagrant"
192.168.56.12 ansible_port=22 ansible_user="vagrant" ansible_ssh_pass="vagrant"
192.168.56.13 ansible_port=22 ansible_user="vagrant" ansible_ssh_pass="vagrant"
192.168.56.14 ansible_port=22 ansible_user="vagrant" ansible_ssh_pass="vagrant"
; 私有云:
; VIP 负载模式:
; 也就是负载均衡器 + keepalived 模式,比如常用的 haproxy + keepalived。
; 本脚本中负载均衡器有 nginx、haproxy、envoy 可供选择,设置 lb_mode 即可进行任意切换。
; 设置 lb_kube_apiserver_ip 即表示启用 keepalived,请先与服务器提供部门协商保留一个IP作为 lb_kube_apiserver_ip,
; 一般 lb 节点组中有两个节点就够了,lb节点组中第一个节点为 keepalived 的 master 节点,剩下的都为 backed 节点。
;
; 节点本地负载模式:
; 只启动负载均衡器,不启用 keepalived(即不设置 lb_kube_apiserver_ip),
; 此时 kubelet 链接 apiserver 地址为 127.0.0.1:lb_kube_apiserver_port。
; 使用此模式时请将 lb 节点组置空。
;
; 公有云:
; 不推荐使用 slb 模式,建议直接使用节点本地负载模式。
; 若使用 slb 模式,请先使用节点本地负载模式进行部署,
; 部署成功后再切换至 slb 模式:
; 将 lb_mode 修改为 slb,将 lb_kube_apiserver_ip 设置为购买到的 slb 内网ip,
; 修改 lb_kube_apiserver_port 为 slb 监听端口。
; 再次运行初始化集群脚本即可切换至 slb 模式。
[lb]
; 注意etcd集群必须是1,3,5,7...奇数个节点
[etcd]
192.168.56.11
192.168.56.12
192.168.56.13
[kube-master]
192.168.56.11
192.168.56.12
192.168.56.13
[kube-worker]
192.168.56.11
192.168.56.12
192.168.56.13
192.168.56.14
; 预留组,后续添加master节点使用
[new-master]
; 预留组,后续添加worker节点使用
[new-worker]
; 预留组,后续添加etcd节点使用
[new-etcd]
;-------------------------------------- 以下为基础信息配置 ------------------------------------;
[all:vars]
; 是否跳过节点物理资源校验,Master节点要求2c2g以上,Worker节点要求2c4g以上
skip_verify_node=false
; kubernetes版本
kube_version="1.15.7"
; 负载均衡器
; 有 nginx、haproxy、envoy 和 slb 四个选项,默认使用 nginx;
lb_mode="nginx"
; 使用负载均衡后集群 apiserver ip,设置 lb_kube_apiserver_ip 变量,则启用负载均衡器 + keepalived
; lb_kube_apiserver_ip="192.168.56.15"
; 使用负载均衡后集群 apiserver port
lb_kube_apiserver_port="8443"
; 网段选择:pod 和 service 的网段不能与服务器网段重叠,
; 若有重叠请配置 `kube_pod_subnet` 和 `kube_service_subnet` 变量设置 pod 和 service 的网段,示例参考:
; 如果服务器网段为:10.0.0.1/8
; pod 网段可设置为:192.168.0.0/18
; service 网段可设置为 192.168.64.0/18
; 如果服务器网段为:172.16.0.1/12
; pod 网段可设置为:10.244.0.0/18
; service 网段可设置为 10.244.64.0/18
; 如果服务器网段为:192.168.0.1/16
; pod 网段可设置为:10.244.0.0/18
; service 网段可设置为 10.244.64.0/18
; 集群pod ip段
kube_pod_subnet="10.244.0.0/18"
; 集群service ip段
kube_service_subnet="10.244.64.0/18"
; 集群网络插件,目前支持flannel,calico,kube-ovn
network_plugin="flannel"
; 若服务器磁盘分为系统盘与数据盘,请修改以下路径至数据盘自定义的目录。
; Kubelet 根目录
kubelet_root_dir="/var/lib/kubelet"
; docker容器存储目录
docker_storage_dir="/var/lib/docker"
; Etcd 数据根目录
etcd_data_dir="/var/lib/etcd"
集群部署
- 若有安全组则需要加上以下安全组策略,规则示例:
授权策略 | 协议类型 | 端口范围 | 授权类型 | 授权对象 | 描述 |
---|---|---|---|---|---|
允许 | TCP | 80⁄80 | 地址段访问 | 0.0.0.0/0 | http 协议访问集群 |
允许 | TCP | 443⁄443 | 地址段访问 | 0.0.0.0/0 | https 协议访问集群 |
允许 | TCP | 30000⁄32767 | 地址段访问 | 0.0.0.0/0 | NodePort 访问集群 |
允许 | 全部 | -1/-1 | 地址段访问 | 10.244.0.0/18 | 跨节点 Pod 之间互相访问 |
- 部署集群:
# 在项目根目录下执行
ansible-playbook -i inventory.ini 90-init-cluster.yml
- 查看等待 pod 的状态为 runnning:
# 任意master节点下执行
kubectl get po --all-namespaces -w
- 如果部署失败,想要重置集群,执行:
# 在项目根目录下执行
ansible-playbook -i inventory.ini 99-reset-cluster.yml
- 其他集群运维操作请查阅项目使用指南
集群网络测试
集群访问公网测试
测试说明
- 镜像中将以下核心代码进行封装成为
curls
命令,使用方式curls url [times]
,例如curls choerodon.io 20
则为访问choerodon.io
20次并打印测试出的时间指标,命令默认访问 10 次。
curl -o /dev/null -s -w '%{time_connect} %{time_starttransfer} %{time_total}' "choerodon.io"
时间指标说明
- 单位:秒
- time_connect:建立到服务器的 TCP 连接所用的时间
- time_starttransfer:在发出请求之后,Web 服务器返回数据的第一个字节所用的时间
- time_total:完成请求所用的时间
场景一、 Kubernetes集群node服务器访问公网
- 测试命令
docker run -it --rm --net=host \
registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0 \
curls choerodon.io
- 测试结果
No time_connect time_starttransfer time_total
1 0.015071 0.027448 0.027570
2 0.010049 0.024527 0.024612
3 0.010025 0.022209 0.022311
4 0.012600 0.025269 0.025369
5 0.012847 0.025849 0.025932
6 0.009973 0.023102 0.023220
7 0.013074 0.029310 0.029411
8 0.015137 0.029992 0.030103
9 0.010994 0.029040 0.029173
10 0.010554 0.022011 0.022130
- 平均响应时间:26ms
场景二、Kubernetes集群Pod访问公网
- 测试命令
kubectl run curl-test \
-it --quiet --rm --restart=Never \
--image='registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0' \
-- bash -c "sleep 3; curls choerodon.io"
- 测试结果
No time_connect time_starttransfer time_total
1 0.014916 0.027232 0.027418
2 0.020213 0.034626 0.034762
3 0.014945 0.028014 0.028165
4 0.016916 0.030483 0.032091
5 0.020519 0.033075 0.033281
6 0.015398 0.027727 0.028003
7 0.015260 0.027099 0.027247
8 0.019549 0.033506 0.033597
9 0.020941 0.032935 0.035226
10 0.014298 0.026570 0.026983
- 平均响应时间:29ms
集群内部网络延迟测试
测试说明
- 测试数据
Service Name: ingress-nginx.ingress-controller.svc
Service Cluster IP: 10.244.64.8 (可通过 kubectl get svc ingress-nginx -n ingress-controller
进行查看)
Service Port: 80
- 通过向
ingress-nginx
的healthz
api执行curl命令进行网络延迟测试
curl "http://10.244.64.8/healthz"
场景一、 Kubernetes集群node服务器上通过Service Cluster IP访问
- 测试命令
docker run -it --rm --net=host \
registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0 \
curls http://10.244.64.8/healthz
- 测试结果
No time_connect time_starttransfer time_total
1 0.000491 0.000983 0.001038
2 0.000347 0.002051 0.002122
3 0.000298 0.000894 0.000975
4 0.000263 0.082559 0.082665
5 0.000351 0.000732 0.000785
6 0.000234 0.084351 0.084445
7 0.000245 0.000550 0.000592
8 0.000436 0.086836 0.086947
9 0.000215 0.000536 0.000573
10 0.000369 0.089528 0.089635
- 平均响应时间:34ms
场景二、Kubernetes集群内部通过service访问
- 测试命令
kubectl run curl-test \
-it --quiet --rm --restart=Never \
--image='registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0' \
-- bash -c "sleep 3; curls http://ingress-nginx.ingress-controller.svc/healthz"
- 测试结果
No time_connect time_starttransfer time_total
1 0.040173 0.080107 0.080205
2 0.047826 0.065836 0.065932
3 0.064808 0.091835 0.091938
4 0.075448 0.087315 0.087410
5 0.112765 0.195511 0.195640
6 0.104970 0.199655 0.199777
7 0.127144 0.139747 0.139834
8 0.056066 0.063325 0.063456
9 0.021773 0.028471 0.028578
10 0.017777 0.023236 0.023330
- 平均响应时间:112ms
集群内部网络性能测试
测试说明
- 使用 iperf 进行测试.
场景一、主机之间
- 服务端命令:
docker run -it --rm --net=host \
registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0 \
iperf -s -p 12345 -i 1 -M
注意: 此时该服务端命令会前台运行,一直等待客户端请求,请另起一个终端窗口进行执行客户端命令。
- 客户端命令:
docker run -it --rm --net=host \
registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0 \
iperf -c 服务端节点IP -p 12345 -i 1 -t 10 -w 20K
- 测试结果
[ ID] Interval Transfer Bandwidth
[ 3] 0.0- 1.0 sec 225 MBytes 1.89 Gbits/sec
[ 3] 1.0- 2.0 sec 223 MBytes 1.87 Gbits/sec
[ 3] 2.0- 3.0 sec 237 MBytes 1.98 Gbits/sec
[ 3] 3.0- 4.0 sec 223 MBytes 1.87 Gbits/sec
[ 3] 4.0- 5.0 sec 273 MBytes 2.29 Gbits/sec
[ 3] 5.0- 6.0 sec 259 MBytes 2.17 Gbits/sec
[ 3] 6.0- 7.0 sec 308 MBytes 2.59 Gbits/sec
[ 3] 7.0- 8.0 sec 257 MBytes 2.16 Gbits/sec
[ 3] 8.0- 9.0 sec 261 MBytes 2.19 Gbits/sec
[ 3] 9.0-10.0 sec 234 MBytes 1.96 Gbits/sec
[ 3] 0.0-10.0 sec 2.44 GBytes 2.10 Gbits/sec
场景二、不同主机的Pod之间
- 服务端命令:
kubectl run iperf-server \
-it --quiet --rm --restart=Never \
--overrides='{"spec":{"nodeName":"指定服务端运行的节点"}}' \
--image='registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0' \
-- bash -c "sleep 3; ifconfig eth0; iperf -s -p 12345 -i 1 -M"
注意: 此时该服务端命令会前台运行,一直等待客户端请求,请另起一个终端窗口进行执行客户端命令。查看输出的日志,替换下面客户端命令中Pod的IP
- 客户端命令:
kubectl run iperf-client \
-it --quiet --rm --restart=Never \
--overrides='{"spec":{"nodeName":"指定客户端运行的节点"}}' \
--image='registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0' \
-- iperf -c 服务端POD的IP -p 12345 -i 1 -t 10 -w 20K
- 测试结果
[ ID] Interval Transfer Bandwidth
[ 3] 0.0- 1.0 sec 1.42 GBytes 12.2 Gbits/sec
[ 3] 1.0- 2.0 sec 1.39 GBytes 11.9 Gbits/sec
[ 3] 2.0- 3.0 sec 1.22 GBytes 10.5 Gbits/sec
[ 3] 3.0- 4.0 sec 1.27 GBytes 10.9 Gbits/sec
[ 3] 4.0- 5.0 sec 1.04 GBytes 8.91 Gbits/sec
[ 3] 5.0- 6.0 sec 1.36 GBytes 11.7 Gbits/sec
[ 3] 6.0- 7.0 sec 1.42 GBytes 12.2 Gbits/sec
[ 3] 7.0- 8.0 sec 1.57 GBytes 13.5 Gbits/sec
[ 3] 8.0- 9.0 sec 1.25 GBytes 10.8 Gbits/sec
[ 3] 9.0-10.0 sec 1.56 GBytes 13.4 Gbits/sec
[ 3] 0.0-10.0 sec 13.5 GBytes 11.6 Gbits/sec
场景三、节点与其他点的 Pod 之间
- 服务端命令:
docker run -it --rm --net=host \
registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0 \
iperf -s -p 12345 -i 1 -M
注意: 此时该服务端命令会前台运行,一直等待客户端请求,请另起一个终端窗口进行执行客户端命令。
- 客户端命令:
kubectl run iperf-client \
-it --quiet --rm --restart=Never \
--overrides='{"spec":{"nodeName":"指定客户端运行的节点"}}' \
--image='registry.cn-hangzhou.aliyuncs.com/choerodon-tools/network-and-cluster-perfermance-test:0.1.0' \
-- iperf -c 服务端节点IP -p 12345 -i 1 -t 10 -w 20K
- 测试结果
[ ID] Interval Transfer Bandwidth
[ 3] 0.0- 1.0 sec 289 MBytes 2.43 Gbits/sec
[ 3] 1.0- 2.0 sec 290 MBytes 2.43 Gbits/sec
[ 3] 2.0- 3.0 sec 226 MBytes 1.89 Gbits/sec
[ 3] 3.0- 4.0 sec 209 MBytes 1.75 Gbits/sec
[ 3] 4.0- 5.0 sec 254 MBytes 2.13 Gbits/sec
[ 3] 5.0- 6.0 sec 257 MBytes 2.15 Gbits/sec
[ 3] 6.0- 7.0 sec 265 MBytes 2.23 Gbits/sec
[ 3] 7.0- 8.0 sec 184 MBytes 1.55 Gbits/sec
[ 3] 8.0- 9.0 sec 217 MBytes 1.82 Gbits/sec
[ 3] 9.0-10.0 sec 236 MBytes 1.98 Gbits/sec
[ 3] 0.0-10.0 sec 2.37 GBytes 2.04 Gbits/sec