二进制安装 vs kubeadm安装
-
kubeadm是官方提供的开源工具,用于快速搭建kubernetes集群,相当于用程序脚本帮我们装好了集群,属于自动部署,简化部署操作,自动部署屏蔽了很多细节,使得对各个模块感知很少,如果对k8s架构组件理解不深的话,遇到问题比较难排查。Kubeadm初始化k8s,所有的组件都是以pod形式运行的,具备故障自恢复能力。kubeadm适合需要经常部署k8s,或者对自动化要求比较高的场景下使用。
-
二进制:在官网下载相关组件的二进制包,如果手动安装,对kubernetes理解也会更全面。
-
Kubeadm和二进制都适合生产环境,在生产环境运行都很稳定,具体如何选择,可以根据实际项目进行评估。
二进制安装多master高可用集群1.20.7
架构图

实验机器规划
-
操作系统:centos7.9
-
配置:4Gib内存/4vCPU/50G硬盘
[!tip] 如果VM是从20G磁盘扩容到了50G,那么在VMWare上加完磁盘容量后需要扩容文件系统。由于使用的镜像的根分区是用的LVM,所以需要LVM扩容。参考文档:LVM扩容指南
-
网络:NAT
-
开启虚拟机的虚拟化
| K8S集群角色 | Ip | 主机名 | 安装的组件 |
|---|---|---|---|
| 控制节点 | 172.16.183.76 | binmaster1 | apiserver、controller-manager、scheduler、etcd、docker、keepalived、nginx |
| 控制节点 | 172.16.183.77 | binmaster2 | apiserver、controller-manager、scheduler、etcd、docker、keepalived、nginx |
| 控制节点 | 172.16.183.78 | binmaster3 | apiserver、controller-manager、scheduler、etcd、docker |
| 工作节点 | 172.16.183.79 | binnode1 | kubelet、kube-proxy、docker、calico、coredns |
| Vip | 172.16.183.75 |
实验环境准备
设置静态IP
vi /etc/sysconfig/network-scripts/ifcfg-ens33
TYPE=Ethernet
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=static #static表示静态ip地址
IPADDR=172.16.183.76 #ip地址,需要跟自己电脑所在网段一致
NETMASK=255.255.255.0
GATEWAY=172.16.183.2
DNS1=172.16.183.2
DEFROUTE=yes
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=ens33 #网卡名字,跟DEVICE名字保持一致即可
DEVICE=ens33 #网卡设备名,ip addr可看到自己的这个网卡设备名
ONBOOT=yes #开机自启动网络,必须是yes
- VMware上由模板机复制过来的VM,要删掉网卡配置的UUID字段
修改主机名
hostnamectl set-hostname binmaster1 && bash #binmaster2 binmaster3 binnode1
配置hosts文件
tee -a /etc/hosts << 'EOF'
172.16.183.76 binmaster1
172.16.183.77 binmaster2
172.16.183.78 binmaster3
172.16.183.79 binnode1
EOF
配置ssh免密登录
ssh-keygen -t rsa
ssh-copy-id -i .ssh/id_rsa.pub binmaster1
关闭firewalld
systemctl stop firewalld && systemctl disable firewalld
关闭Selinux
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
reboot -f
关闭交换分区
swapoff -a
vim /etc/fstab
#/dev/mapper/centos-swap swap swap defaults 0 0
修改内核参数-开路由转发
modprobe br_netfilter
lsmod | grep br_netfilter
echo "modprobe br_netfilter" >> /etc/profile
cat > /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/k8s.conf
配置阿里云repo源
#安装rzsz命令
yum install lrzsz -y
#安装scp
yum install openssh-clients -y
#备份基础repo源
mkdir /root/repo.bak/
mv /etc/yum.repos.d/* /root/repo.bak/
#下载阿里云的repo源
#把CentOS-Base.repo文件上传到master1主机的/etc/yum.repos.d/目录下
#或者直接创建/etc/yum.repos.d/CentOS-Base.repo
vi /etc/yum.repos.d/CentOS-Base.repo
# CentOS-Base.repo
#
# The mirror system uses the connecting IP address of the client and the
# update status of each mirror to pick mirrors that are updated to and
# geographically close to the client. You should use this for CentOS updates
# unless you are manually picking other mirrors.
#
# If the mirrorlist= does not work for you, as a fall back you can try the
# remarked out baseurl= line instead.
#
#
[base]
name=CentOS-$releasever - Base - mirrors.aliyun.com
failovermethod=priority
baseurl=http://mirrors.aliyun.com/centos/$releasever/os/$basearch/
http://mirrors.aliyuncs.com/centos/$releasever/os/$basearch/
http://mirrors.cloud.aliyuncs.com/centos/$releasever/os/$basearch/
gpgcheck=1
gpgkey=http://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7
#released updates
[updates]
name=CentOS-$releasever - Updates - mirrors.aliyun.com
failovermethod=priority
baseurl=http://mirrors.aliyun.com/centos/$releasever/updates/$basearch/
http://mirrors.aliyuncs.com/centos/$releasever/updates/$basearch/
http://mirrors.cloud.aliyuncs.com/centos/$releasever/updates/$basearch/
gpgcheck=1
gpgkey=http://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7
#additional packages that may be useful
[extras]
name=CentOS-$releasever - Extras - mirrors.aliyun.com
failovermethod=priority
baseurl=http://mirrors.aliyun.com/centos/$releasever/extras/$basearch/
http://mirrors.aliyuncs.com/centos/$releasever/extras/$basearch/
http://mirrors.cloud.aliyuncs.com/centos/$releasever/extras/$basearch/
gpgcheck=1
gpgkey=http://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7
#additional packages that extend functionality of existing packages
[centosplus]
name=CentOS-$releasever - Plus - mirrors.aliyun.com
failovermethod=priority
baseurl=http://mirrors.aliyun.com/centos/$releasever/centosplus/$basearch/
http://mirrors.aliyuncs.com/centos/$releasever/centosplus/$basearch/
http://mirrors.cloud.aliyuncs.com/centos/$releasever/centosplus/$basearch/
gpgcheck=1
enabled=0
gpgkey=http://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7
#contrib - packages by Centos Users
[contrib]
name=CentOS-$releasever - Contrib - mirrors.aliyun.com
failovermethod=priority
baseurl=http://mirrors.aliyun.com/centos/$releasever/contrib/$basearch/
http://mirrors.aliyuncs.com/centos/$releasever/contrib/$basearch/
http://mirrors.cloud.aliyuncs.com/centos/$releasever/contrib/$basearch/
gpgcheck=1
enabled=0
gpgkey=http://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7
配置阿里云docker源
yum install yum-utils -y
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
#会把阿里云的docker源的配置给拉下来。
安装基础软件包
yum install -y device-mapper-persistent-data lvm2 wget net-tools nfs-utils lrzsz gcc gcc-c++ make cmake libxml2-devel openssl-devel curl curl-devel unzip sudo ntp libaio-devel wget vim ncurses-devel autoconf automake zlib-devel python-devel epel-release openssh-server socat conntrack telnet ipvsadm openssh-clients
yum install如果出现报错:GPG key retrieval failed: [Errno 14] curl#37 - "Couldn't open file /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7"
意思是,yum源开启了GPG校验,需要在/etc/pki/rpm-gpg目录下存在对应安装文件的公钥文件,才能完成校验。
可以关闭掉校验:
sed -i 's/pgcheck=1/pgcheck=0/g' /etc/yum.repos.d/epel.repo
配置时间同步
#安装ntpdate命令
yum install ntpdate -y
#跟网络时间做同步
ntpdate cn.pool.ntp.org
#把时间同步做成计划任务
crontab -e
* */1 * * * /usr/sbin/ntpdate cn.pool.ntp.org
#重启crond服务
service crond restart
安装iptables
#安装iptables
yum install iptables-services -y
#禁用iptables
service iptables stop && systemctl disable iptables
#清空防火墙规则
iptables -F
开启IPVS
- 不开启ipvs将会使用iptables进行数据包转发,但是效率低,所以官网推荐需要开通ipvs。
#把ipvs.modules上传到/etc/sysconfig/modules/目录下
vim /etc/sysconfig/modules/ipvs.modules
#脚本内容:
#!/bin/bash
ipvs_modules="ip_vs ip_vs_lc ip_vs_wlc ip_vs_rr ip_vs_wrr ip_vs_lblc ip_vs_lblcr ip_vs_dh ip_vs_sh ip_vs_nq ip_vs_sed ip_vs_ftp nf_conntrack"
for kernel_module in ${ipvs_modules}; do
/sbin/modinfo -F filename ${kernel_module} > /dev/null 2>&1
if [ 0 -eq 0 ]; then
/sbin/modprobe ${kernel_module}
fi
done
#赋权,加载内核模块
chmod 755 /etc/sysconfig/modules/ipvs.modules && bash /etc/sysconfig/modules/ipvs.modules && lsmod | grep ip_vs
ipvs (IP Virtual Server) 实现了传输层负载均衡,也就是我们常说的4层LAN交换,作为 Linux 内核的一部分。ipvs运行在主机上,在真实服务器集群前充当负载均衡器。ipvs可以将基于TCP和UDP的服务请求转发到真实服务器上,并使真实服务器的服务在单个 IP 地址上显示为虚拟服务。
kube-proxy支持 iptables 和 ipvs 两种模式, 在kubernetes v1.8 中引入了 ipvs 模式,在 v1.9 中处于 beta 阶段,在 v1.11 中已经正式可用了。iptables 模式在 v1.1 中就添加支持了,从 v1.2 版本开始 iptables 就是 kube-proxy 默认的操作模式,ipvs 和 iptables 都是基于netfilter的,但是ipvs采用的是hash表,因此当service数量达到一定规模时,hash查表的速度优势就会显现出来,从而提高service的服务性能。那么 ipvs 模式和 iptables 模式之间有哪些差异呢?
1、ipvs 为大型集群提供了更好的可扩展性和性能
2、ipvs 支持比 iptables 更复杂的复制均衡算法(最小负载、最少连接、加权等等)
3、ipvs 支持服务器健康检查和连接重试等功能
安装配置docker-ce
- 安装
yum install docker-ce docker-ce-cli containerd.io -y
systemctl start docker && systemctl enable docker.service && systemctl status docker
- 配置镜像加速器
tee /etc/docker/daemon.json << 'EOF'
{
"registry-mirrors":["https://docker.m.daocloud.io"],
"exec-opts": ["native.cgroupdriver=systemd"]
}
EOF
systemctl daemon-reload
systemctl restart docker
systemctl status docker
#修改docker文件驱动为systemd,默认为cgroupfs,kubelet默认使用systemd,两者必须一致才可以。
搭建etcd集群
配置ectd工作目录
#3台master上
mkdir -p /etc/etcd/ssl
安装签发证书工具cfssl
cfssl 是 CloudFlare 开源的一款PKI/TLS工具。 CFSSL 包含一个命令行工具(cfssl, cfssljson)用于签名,可以生成CA,签发证书
使用cfssl需要两个文件:
1、创建自己的内部服务使用的CA认证中心
2、运行认证中心需要一个CA证书和相应的私钥。后者是极其敏感的数据。任何知道私钥的人都可以充当CA颁发证书。因此,私钥的保护至关重要
#在master1上
mkdir /data/work -p
cd /data/work/
#cfssl-certinfo_linux-amd64 、cfssljson_linux-amd64 、cfssl_linux-amd64上传到/data/work/目录下
ls
cfssl-certinfo_linux-amd64 cfssljson_linux-amd64 cfssl_linux-amd64
#把文件变成可执行权限
chmod +x *
mv cfssl_linux-amd64 /usr/local/bin/cfssl
mv cfssljson_linux-amd64 /usr/local/bin/cfssljson
mv cfssl-certinfo_linux-amd64 /usr/local/bin/cfssl-certinfo
配置CA证书请求
#生成ca证书请求文件,mater1上
#CA证书请求文件,也被称为CSR(Certificate Signing Request),是一种由服务器管理员或者网站所有者生成的特殊文件。它包含了公钥以及一些附加信息,如组织名称、常用名称(例如网站域名)等。这个文件会被发送给证书颁发机构(CA,Certificate Authority),CA会基于这个请求生成一个数字证书。
cd /data/work/
tee -a ca-csr.json << 'EOF'
{
"CN": "kubernetes",
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "k8s",
"OU": "system"
}
],
"ca": {
"expiry": "87600h"
}
}
EOF
cfssl gencert -initca ca-csr.json | cfssljson -bare ca
注:
CN:Common Name(公用名称),kube-apiserver 从证书中提取该字段作为请求的用户名 (User Name);浏览器使用该字段验证网站是否合法;对于 SSL 证书,一般为网站域名;而对于代码签名证书则为申请单位名称;而对于客户端证书则为证书申请者的姓名。
O:Organization(单位名称),kube-apiserver 从证书中提取该字段作为请求用户所属的组 (Group);对于 SSL 证书,一般为网站域名;而对于代码签名证书则为申请单位名称;而对于客户端单位证书则为证书申请者所在单位名称。
L 字段:所在城市
S 字段:所在省份
C 字段:只能是国家字母缩写,如中国:CN
cfssljson是CloudFlare的PKI(TLS/SSL)工具包cfssl的一部分。这个命令主要用于处理cfssl生成的JSON格式的输出。
cfssljson的主要功能是从cfssl的输出中提取和写入证书,私钥和证书链。这对于自动化处理证书生成和部署非常有用。例如,你可以使用cfssl和cfssljson生成一个新的自签名证书:
cfssl gencert -initca ca-csr.json | cfssljson -bare ca
- 在这个例子中,
cfssl gencert -initca ca-csr.json生成一个新的自签名证书和私钥,然后通过管道传递给cfssljson -bare ca,它从JSON输出中提取证书和私钥,并将它们分别写入ca.pem和ca-key.pem文件。后面所有证书都是由ca.pem这个证书来颁发的
生成CA证书文件
tee -a ca-config.json << 'EOF'
{
"signing": {
"default": {
"expiry": "87600h"
},
"profiles": {
"kubernetes": {
"usages": [
"signing",
"key encipherment",
"server auth",
"client auth"
],
"expiry": "87600h"
}
}
}
}
EOF
生成etcd证书
#配置etcd证书请求,hosts的ip变成自己etcd所在节点的ip。可以预先写进去一些冗余的IP,方便后面扩容。
tee -a etcd-csr.json << 'EOF'
{
"CN": "etcd",
"hosts": [
"127.0.0.1",
"172.16.183.76",
"172.16.183.77",
"172.16.183.78",
"172.16.183.79",
"172.16.183.75"
],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "k8s",
"OU": "system"
}]
}
EOF
#上述文件hosts字段中IP为所有etcd节点的集群内部通信IP,可以预留几个,做扩容用?
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes etcd-csr.json | cfssljson -bare etcd
ls etcd*.pem
#etcd-key.pem etcd.pem
在生成证书过程中需要有四类文件
- *.csr - 证书请求文件,base64格式,有-----BEGIN CERTIFICATE REQUEST-----标识
- *csr.json - 证书请求文件,是上面格式的再封装,便于传给cfssl,json格式,大括号开始
- *-key.pem - 私匙文件,base64格式,有-----BEGIN RSA PRIVATE KEY-----标识
- *.pem - 证书文件,base64格式,可以用cfssl certinfo -cert 文件名查看有效期,有-----BEGIN CERTIFICATE-----标识
部署etcd集群
上传镜像
- 上传etcd-v3.4.13-linux-amd64.tar.gz上传到master1的/data/work目录下
tar -xf etcd-v3.4.13-linux-amd64.tar.gz
cp -p etcd-v3.4.13-linux-amd64/etcd* /usr/local/bin/
#拷贝到另外两台
scp -r etcd-v3.4.13-linux-amd64/etcd* binmaster2:/usr/local/bin/
scp -r etcd-v3.4.13-linux-amd64/etcd* binmaster3:/usr/local/bin/
创建配置文件
tee -a etcd.conf << 'EOF'
#[Member]
ETCD_NAME="etcd1"
ETCD_DATA_DIR="/var/lib/etcd/default.etcd"
ETCD_LISTEN_PEER_URLS="https://172.16.183.76:2380"
ETCD_LISTEN_CLIENT_URLS="https://172.16.183.76:2379,http://127.0.0.1:2379"
#[Clustering]
ETCD_INITIAL_ADVERTISE_PEER_URLS="https://172.16.183.76:2380"
ETCD_ADVERTISE_CLIENT_URLS="https://172.16.183.76:2379"
ETCD_INITIAL_CLUSTER="etcd1=https://172.16.183.76:2380,etcd2=https://172.16.183.77:2380,etcd3=https://172.16.183.78:2380"
ETCD_INITIAL_CLUSTER_TOKEN="etcd-cluster"
ETCD_INITIAL_CLUSTER_STATE="new"
EOF
ETCD_NAME:节点名称,集群中唯一
ETCD_DATA_DIR:数据目录
ETCD_LISTEN_PEER_URLS:集群通信监听地址
ETCD_LISTEN_CLIENT_URLS:客户端访问监听地址
ETCD_INITIAL_ADVERTISE_PEER_URLS:集群通告地址
ETCD_ADVERTISE_CLIENT_URLS:客户端通告地址
ETCD_INITIAL_CLUSTER:集群节点地址
ETCD_INITIAL_CLUSTER_TOKEN:集群Token
ETCD_INITIAL_CLUSTER_STATE:加入集群的当前状态,new是新集群,existing表示加入已有集群
创建启动服务文件
#master1上
tee -a etcd.service << 'EOF'
[Unit]
Description=Etcd Server
After=network.target
After=network-online.target
Wants=network-online.target
[Service]
Type=notify
EnvironmentFile=-/etc/etcd/etcd.conf
WorkingDirectory=/var/lib/etcd/
ExecStart=/usr/local/bin/etcd \
--cert-file=/etc/etcd/ssl/etcd.pem \
--key-file=/etc/etcd/ssl/etcd-key.pem \
--trusted-ca-file=/etc/etcd/ssl/ca.pem \
--peer-cert-file=/etc/etcd/ssl/etcd.pem \
--peer-key-file=/etc/etcd/ssl/etcd-key.pem \
--peer-trusted-ca-file=/etc/etcd/ssl/ca.pem \
--peer-client-cert-auth \
--client-cert-auth
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
EOF
#master1上,把前面生成的证书文件转移到/etc/etcd/ssl/
cd /data/work
cp ca*.pem /etc/etcd/ssl/
cp etcd*.pem /etc/etcd/ssl/
cp etcd.conf /etc/etcd/
cp etcd.service /usr/lib/systemd/system/ # 这是系统启动脚本的目录
for i in binmaster2 binmaster3;do rsync -vaz etcd.conf $i:/etc/etcd/;done
for i in binmaster2 binmaster3;do rsync -vaz etcd*.pem ca*.pem $i:/etc/etcd/ssl/;done
for i in binmaster2 binmaster3;do rsync -vaz etcd.service $i:/usr/lib/systemd/system/;done
启动etcd集群
#3台master上,创建etcd的数据目录
mkdir -p /var/lib/etcd/default.etcd
#master2上
tee -a /etc/etcd/etcd.conf << 'EOF'
#[Member]
ETCD_NAME="etcd2"
ETCD_DATA_DIR="/var/lib/etcd/default.etcd"
ETCD_LISTEN_PEER_URLS="https://172.16.183.77:2380"
ETCD_LISTEN_CLIENT_URLS="https://172.16.183.77:2379,http://127.0.0.1:2379"
#[Clustering]
ETCD_INITIAL_ADVERTISE_PEER_URLS="https://172.16.183.77:2380"
ETCD_ADVERTISE_CLIENT_URLS="https://172.16.183.77:2379"
ETCD_INITIAL_CLUSTER="etcd1=https://172.16.183.76:2380,etcd2=https://172.16.183.77:2380,etcd3=https://172.16.183.78:2380"
ETCD_INITIAL_CLUSTER_TOKEN="etcd-cluster"
ETCD_INITIAL_CLUSTER_STATE="new"
EOF
#master3上
tee -a /etc/etcd/etcd.conf << 'EOF'
#[Member]
ETCD_NAME="etcd3"
ETCD_DATA_DIR="/var/lib/etcd/default.etcd"
ETCD_LISTEN_PEER_URLS="https://172.16.183.78:2380"
ETCD_LISTEN_CLIENT_URLS="https://172.16.183.78:2379,http://127.0.0.1:2379"
#[Clustering]
ETCD_INITIAL_ADVERTISE_PEER_URLS="https://172.16.183.78:2380"
ETCD_ADVERTISE_CLIENT_URLS="https://172.16.183.78:2379"
ETCD_INITIAL_CLUSTER="etcd1=https://172.16.183.76:2380,etcd2=https://172.16.183.77:2380,etcd3=https://172.16.183.78:2380"
ETCD_INITIAL_CLUSTER_TOKEN="etcd-cluster"
ETCD_INITIAL_CLUSTER_STATE="new"
EOF
#master1\2\3上
systemctl daemon-reload
systemctl enable etcd.service
systemctl start etcd.service
#启动etcd的时候,先启动master1的etcd服务,会一直卡住在启动的状态,然后接着再启动master2的etcd,这样master1这个节点etcd才会正常起来
#3台上检查etcd状态
systemctl status etcd
查看etcd集群健康状态
#master1上
ETCDCTL_API=3 #设置etcdctl api版本为3
echo $ETCDCTL_API
/usr/local/bin/etcdctl --write-out=table --cacert=/etc/etcd/ssl/ca.pem --cert=/etc/etcd/ssl/etcd.pem --key=/etc/etcd/ssl/etcd-key.pem --endpoints=https://172.16.183.76:2379,https://172.16.183.77:2379,https://172.16.183.78:2379 endpoint health
安装k8s组件
- Kubernetes API的请求从发起到其持久化⼊库的流程如下:
- 认证阶段(Authentication)
- 判断⽤户是否为能够访问集群的合法⽤户。
- apiserver⽬前提供了9种认证机制。每⼀种认证机制被实例化后会成为认证器(Authenticator),每⼀个认证器都被封装在http.Handler请求处理函数中,它们接收组件或客户端的请求并认证请求。
- 假设所有的认证器都被启⽤,当客户端发送请求到kube-apiserver服务,该请求会进⼊Authentication Handler函数(处理认证相关的Handler函数)。在Authentication Handler函数中,会遍历已启⽤的认证器列表,尝试执⾏每个认证器,当有⼀个认证器返回true时,则认证成功,否则继续尝试下⼀个认证器;如果⽤户是个⾮法⽤户,那apiserver会返回⼀个401的状态码,并终⽌该请求。
- clientCA认证
- X509认证是Kubernetes组件间默认使⽤的认证⽅式,同时也是kubectl客户端对应的kube-config中经常使⽤到的访问凭证。它是⼀个⽐较安全的⽅式。
- ⾸先访问者会使⽤由集群CA签发的,或是添加在apiserver配置中的授信CA签发的客户端证书去访问apiserver。apiserver在接收到请求后,会进⾏TLS的握⼿流程。
- 除了验证证书的合法性,apiserver还会校验客户端证书的请求源地址等信息,开启双向认证。
下载安装包
- 二进制包所在的github地址如下:Kubernetes CHANGELOG,可以按照版本下载二进制包。控制节点组件,找到Server Binaries,下载amd64版本的。server binaries二进制包里面就包含了:controller-manager,apiserver,scheduler等控制平面组件。其实也包含了工作节点需要的kubelet和kubeproxy
- 这里下载的是1.20.7版本
#把kubernetes-server-linux-amd64.tar.gz上传到master1上的/data/work目录下:
#master1上
cd /data/work
tar zxvf kubernetes-server-linux-amd64.tar.gz
cd kubernetes/server/bin/
cp kube-apiserver kube-controller-manager kube-scheduler kubectl /usr/local/bin/
rsync -vaz kube-apiserver kube-controller-manager kube-scheduler kubectl binmaster2:/usr/local/bin/
rsync -vaz kube-apiserver kube-controller-manager kube-scheduler kubectl binmaster3:/usr/local/bin/
#kubelet kubeproxy放到工作节点
scp kubelet kube-proxy binnode1:/usr/local/bin/
cd /data/work/
mkdir -p /etc/kubernetes/ssl/
mkdir -p /var/log/kubernetes
部署apiserver组件
bootstrapping机制
- 启动TLS Bootstrapping 机制
- Master apiserver启用TLS认证后,每个节点的 kubelet 组件都要使用由 apiserver 使用的 CA 签发的有效证书才能与 apiserver 通讯,当Node节点很多时,这种客户端证书颁发需要大量工作,同样也会增加集群扩展复杂度。
-
为了简化流程,Kubernetes引入了TLS bootstraping机制来自动颁发客户端证书,kubelet会以一个低权限用户自动向apiserver申请证书,kubelet的证书由apiserver动态签署。
-
Bootstrap 是很多系统中都存在的程序,比如 Linux 的bootstrap,bootstrap 一般都是作为预先配置在开启或者系统启动的时候加载,这可以用来生成一个指定环境。Kubernetes 的 kubelet 在启动时同样可以加载一个这样的配置文件,这个文件的内容类似如下形式:
apiVersion: v1
clusters: null
contexts:
- context:
cluster: kubernetes
user: kubelet-bootstrap
name: default
current-context: default
kind: Config
preferences: {}
users:
- name: kubelet-bootstrap
user: {}
- Bootstrap具体引导过程
- TLS 作用
TLS 的作用就是对通讯加密,防止中间人窃听;同时如果证书不信任的话根本就无法与 apiserver 建立连接,更不用提有没有权限向apiserver请求指定内容。 - RBAC 作用
当 TLS 解决了通讯问题后,那么权限问题就应由 RBAC 解决;RBAC 中规定了一个用户或者用户组(subject)具有请求哪些 api 的权限;在配合 TLS 加密的时候,实际上 apiserver 读取客户端证书的CN字段作为用户名,读取O字段作为用户组. -
以上说明:第一,想要与 apiserver 通讯就必须采用由 apiserver CA 签发的证书,这样才能形成信任关系,建立 TLS 连接;第二,可以通过证书的 CN、O 字段来提供 RBAC 所需的用户与用户组。
-
kubelet 首次启动流程
-
TLS bootstrapping 功能是让 kubelet 组件去 apiserver 申请证书,然后用于连接 apiserver;那么第一次启动时没有证书如何连接 apiserver ?
-
在apiserver 配置中指定了一个
token.csv文件,该文件中是一个预设的用户配置;- 同时该用户的Token和apiserver CA签发的用户被写入了kubelet的
bootstrap.kubeconfig配置文件中; - 这样在首次请求时,kubelet 使用
bootstrap.kubeconfig中被apiserver CA信任的用户与apiserver连接,使用bootstrap.kubeconfig中的用户 Token 来向 apiserver 声明自己的 RBAC 授权身份.
- 同时该用户的Token和apiserver CA签发的用户被写入了kubelet的
-
token.csv格式:
3940fd7fbb391d1b4d861ad17a1f0613,kubelet-bootstrap,10001,"system:kubelet-bootstrap" -
首次启动时,可能与遇到 kubelet 报 401 无权访问 apiserver 的错误;这是因为在默认情况下,kubelet 通过
bootstrap.kubeconfig中的预设用户 Token 声明了自己的身份,然后创建 CSR 请求。但是不要忘记这个用户在我们不处理的情况下他没任何权限的,包括创建CSR请求的权限也没有。所以需要创建一个ClusterRoleBinding,将预设用户kubelet-bootstrap与内置的ClusterRole system:node-bootstrapper绑定到一起,使其能够发起 CSR 请求。
创建token.csv文件
#master1上
cat > token.csv << EOF
$(head -c 16 /dev/urandom | od -An -t x | tr -d ' '),kubelet-bootstrap,10001,"system:kubelet-bootstrap"
EOF
#格式:token,用户名,UID,用户组
创建csr请求文件
-
集群中所有系统组件与apiserver通讯⽤到的证书,其实都是由集群根CA签发的
-
注:如果 hosts 字段不为空则需要指定授权使用该证书的 IP 或域名列表。由于该证书后续被 kubernetes master 集群使用,需要将master节点的IP都填上,同时还需要填写 service 网络的首个IP。(一般是 kube-apiserver 指定的 service-cluster-ip-range 网段的第一个IP,如 10.255.0.1)
#master1上
tee -a kube-apiserver-csr.json << 'EOF'
{
"CN": "kubernetes",
"hosts": [
"127.0.0.1",
"172.16.183.76",
"172.16.183.77",
"172.16.183.78",
"172.16.183.79",
"172.16.183.75",
"10.255.0.1",
"kubernetes",
"kubernetes.default",
"kubernetes.default.svc",
"kubernetes.default.svc.cluster",
"kubernetes.default.svc.cluster.local"
],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "k8s",
"OU": "system"
}
]
}
EOF
生成证书
#master1上
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kube-apiserver-csr.json | cfssljson -bare kube-apiserver
创建apiserver的配置文件
#master1上
tee -a kube-apiserver.conf << 'EOF'
KUBE_APISERVER_OPTS="--enable-admission-plugins=NamespaceLifecycle,NodeRestriction,LimitRanger,ServiceAccount,DefaultStorageClass,ResourceQuota \
--anonymous-auth=false \
--bind-address=172.16.183.76 \
--secure-port=6443 \
--advertise-address=172.16.183.76 \
--insecure-port=0 \
--authorization-mode=Node,RBAC \
--runtime-config=api/all=true \
--enable-bootstrap-token-auth \
--service-cluster-ip-range=10.255.0.0/16 \
--token-auth-file=/etc/kubernetes/token.csv \
--service-node-port-range=30000-50000 \
--tls-cert-file=/etc/kubernetes/ssl/kube-apiserver.pem \
--tls-private-key-file=/etc/kubernetes/ssl/kube-apiserver-key.pem \
--client-ca-file=/etc/kubernetes/ssl/ca.pem \
--kubelet-client-certificate=/etc/kubernetes/ssl/kube-apiserver.pem \
--kubelet-client-key=/etc/kubernetes/ssl/kube-apiserver-key.pem \
--service-account-key-file=/etc/kubernetes/ssl/ca-key.pem \
--service-account-signing-key-file=/etc/kubernetes/ssl/ca-key.pem \
--service-account-issuer=https://kubernetes.default.svc.cluster.local \
--etcd-cafile=/etc/etcd/ssl/ca.pem \
--etcd-certfile=/etc/etcd/ssl/etcd.pem \
--etcd-keyfile=/etc/etcd/ssl/etcd-key.pem \
--etcd-servers=https://172.16.183.76:2379,https://172.16.183.77:2379,https://172.16.183.78:2379 \
--enable-swagger-ui=true \
--allow-privileged=true \
--apiserver-count=3 \
--audit-log-maxage=30 \
--audit-log-maxbackup=3 \
--audit-log-maxsize=100 \
--audit-log-path=/var/log/kube-apiserver-audit.log \
--event-ttl=1h \
--alsologtostderr=true \
--logtostderr=false \
--log-dir=/var/log/kubernetes \
--v=4"
EOF
注:
--logtostderr:启用日志
--v:日志等级
--log-dir:日志目录
--etcd-servers:etcd集群地址
--bind-address:监听地址
--secure-port:https安全端口
--advertise-address:集群通告地址
--allow-privileged:启用授权
--service-cluster-ip-range:Service虚拟IP地址段
--enable-admission-plugins:准入控制模块
--authorization-mode:认证授权,启用RBAC授权和节点自管理
--enable-bootstrap-token-auth:启用TLS bootstrap机制
--token-auth-file:bootstrap token文件
--service-node-port-range:Service nodeport类型默认分配端口范围
--kubelet-client-xxx:apiserver访问kubelet客户端证书
--tls-xxx-file:apiserver https证书
--etcd-xxxfile:连接Etcd集群证书 –
-audit-log-xxx:审计日志
创建服务启动文件
#master1上
tee -a kube-apiserver.service << 'EOF'
[Unit]
Description=Kubernetes API Server
Documentation=https://github.com/kubernetes/kubernetes
After=etcd.service
Wants=etcd.service
[Service]
EnvironmentFile=-/etc/kubernetes/kube-apiserver.conf
ExecStart=/usr/local/bin/kube-apiserver $KUBE_APISERVER_OPTS
Restart=on-failure
RestartSec=5
Type=notify
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
EOF
cp ca*.pem /etc/kubernetes/ssl
cp kube-apiserver*.pem /etc/kubernetes/ssl/
cp token.csv /etc/kubernetes/
cp kube-apiserver.conf /etc/kubernetes/
cp kube-apiserver.service /usr/lib/systemd/system/
rsync -vaz token.csv binmaster2:/etc/kubernetes/
rsync -vaz token.csv binmaster3:/etc/kubernetes/
rsync -vaz kube-apiserver*.pem binmaster2:/etc/kubernetes/ssl/
rsync -vaz kube-apiserver*.pem binmaster3:/etc/kubernetes/ssl/
rsync -vaz ca*.pem binmaster2:/etc/kubernetes/ssl/
rsync -vaz ca*.pem binmaster3:/etc/kubernetes/ssl/
rsync -vaz kube-apiserver.conf binmaster2:/etc/kubernetes/
rsync -vaz kube-apiserver.conf binmaster3:/etc/kubernetes/
rsync -vaz kube-apiserver.service binmaster2:/usr/lib/systemd/system/
rsync -vaz kube-apiserver.service binmaster3:/usr/lib/systemd/system/
#修改master2和master3上的kube-apiserver.conf文件的IP地址(--bind-address,--advertise-address)
#3台master上执行
systemctl daemon-reload
systemctl enable kube-apiserver
systemctl start kube-apiserver
systemctl status kube-apiserver
curl --insecure https://172.16.183.76:6443/
#上面看到401,这个是正常的的状态,还没认证
部署kubectl组件
配置kubeconfig文件
- Kubectl操作资源的时候,怎么知道连接到哪个集群?需要一个文件/etc/kubernetes/admin.conf,kubectl会根据这个文件的配置,去访问k8s资源。/etc/kubernetes/admin.conf文件记录了访问的k8s集群,和用到的证书。
#可以设置一个环境变量KUBECONFIG,这样操作kubectl,就会自动加载KUBECONFIG来操作要管理哪个集群的k8s资源了
#直接命令行定义环境变量,只对当前的shell有效
export KUBECONFIG=/etc/kubernetes/admin.conf
#编辑/etc/profile,对于所有用户,永久生效(也可以在用户家目录下的.bash_profile增加环境变量,对当前用户永久生效)
tee -a /etc/profile << 'EOF'
export KUBECONFIG=/etc/kubernetes/admin.conf
EOF
source /etc/profile
#也可以按照下面方法,这个是在kubeadm初始化k8s的时候会告诉我们要用的方法
cp /etc/kubernetes/admin.conf /root/.kube/config
#如果设置了KUBECONFIG,那就会先找到KUBECONFIG去操作k8s,如果没有KUBECONFIG变量,那就会使用/root/.kube/config文件决定管理哪个k8s集群的资源。
二进制安装这里没有admin.conf这个文件,直接就用/root/.kube/config,所以不用做上面的步骤
创建csr请求文件
#master1上
cd /data/work
#创建一个集群管理员的user,叫admin,组是system:master,这个组已经预先内置了cluster-admin的权限。
tee -a admin-csr.json << 'EOF'
{
"CN": "admin",
"hosts": [],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "system:masters",
"OU": "system"
}
]
}
EOF
说明:
后续 kube-apiserver 使用 RBAC 对客户端(如 kubelet、kube-proxy、Pod)请求进行授权;
kube-apiserver 预定义了一些 RBAC 使用的 RoleBindings,如 cluster-admin 将 Group system:masters 与 Role cluster-admin 绑定,该 Role 授予了调用apiserver的所有API的权限;
O指定该证书的 Group 为 system:masters,kubelet 使用该证书访问apiserver时,由于证书被 CA 签名,所以认证通过;同时由于证书用户组为经过预授权的 system:masters,所以被授予访问所有 API 的权限;
注:
- 这个admin证书是将来生成管理员用的kube config 配置文件用的,现在我们一般建议使用RBAC来对kubernetes进行角色权限控制,kubernetes将证书中的CN字段作为User, O 字段作为 Group; "O": "system:masters", 必须是system:masters,否则后面kubectl create clusterrolebinding报错。
生成证书
#master1上
cd /data/work
#用apiserver的证书颁发机构,给kubectl客户端签发了一个admin客户端证书
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes admin-csr.json | cfssljson -bare admin
cp admin*.pem /etc/kubernetes/ssl/
配置安全上下文
- 创建kubeconfig配置文件
#kubeconfig 为 kubectl 的配置文件,包含访问 apiserver 的所有信息,如 apiserver 地址、CA 证书和自身使用的证书(这里如果报错找不到kubeconfig路径,请手动复制到相应路径下,没有则忽略)
#1.设置集群参数
cd /data/work
kubectl config set-cluster kubernetes --certificate-authority=ca.pem --embed-certs=true --server=https://172.16.183.76:6443 --kubeconfig=kube.config #这一步会生成kube.config文件,就是后面的/kube/config文件。
##查看kube.config内容
vim kube.config
#2.设置客户端认证参数
kubectl config set-credentials admin --client-certificate=admin.pem --client-key=admin-key.pem --embed-certs=true --kubeconfig=kube.config
#3.设置上下文参数
kubectl config set-context kubernetes --cluster=kubernetes --user=admin --kubeconfig=kube.config
#4.设置当前上下文
kubectl config use-context kubernetes --kubeconfig=kube.config
mkdir ~/.kube -p
cp kube.config ~/.kube/config
#5.授权kubernetes证书访问kubelet api权限,目的是可以创建资源。#注意这里的用户是kubernetes,这是前面apiserver的ca-csr文件里面定义的CN=kubernetes,代表给apiserver赋予api的权限
kubectl create clusterrolebinding kube-apiserver:kubelet-apis --clusterrole=system:kubelet-api-admin --user kubernetes
##查看集群组件状态
kubectl cluster-info
kubectl get componentstatuses
kubectl get all --all-namespaces
#同步kubectl文件到其他节点
##master2和3上
mkdir /root/.kube/ -p
##master1上
rsync -vaz /root/.kube/config binmaster2:/root/.kube/
rsync -vaz /root/.kube/config binmaster3:/root/.kube/
#配置kubectl子命令补全
##master1上
yum install -y bash-completion
source /usr/share/bash-completion/bash_completion
source <(kubectl completion bash)
kubectl completion bash > ~/.kube/completion.bash.inc
source '/root/.kube/completion.bash.inc'
source $HOME/.bash_profile
部署kube-controller-manager组件
创建csr请求文件
#master1上
cd /data/work
tee -a kube-controller-manager-csr.json << 'EOF'
{
"CN": "system:kube-controller-manager",
"key": {
"algo": "rsa",
"size": 2048
},
"hosts": [
"127.0.0.1",
"172.16.183.76",
"172.16.183.77",
"172.16.183.78",
"172.16.183.79"
],
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "system:kube-controller-manager",
"OU": "system"
}
]
}
EOF
注:hosts 列表包含所有 kube-controller-manager 节点 IP; CN 为 system:kube-controller-manager、O 为 system:kube-controller-manager,kubernetes 内置的 ClusterRoleBindings system:kube-controller-manager 赋予 kube-controller-manager 工作所需的权限
生成证书
#master1上
cd /data/work
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kube-controller-manager-csr.json | cfssljson -bare kube-controller-manager
创建kube-controller-manager的kubeconfig
#master1上
cd /data/work
#1.设置集群参数,指定apiserver信任的
kubectl config set-cluster kubernetes --certificate-authority=ca.pem --embed-certs=true --server=https://172.16.183.76:6443 --kubeconfig=kube-controller-manager.kubeconfig
#2.设置客户端认证参数,指定客户端使用的证书
kubectl config set-credentials system:kube-controller-manager --client-certificate=kube-controller-manager.pem --client-key=kube-controller-manager-key.pem --embed-certs=true --kubeconfig=kube-controller-manager.kubeconfig
#3.设置上下文参数
kubectl config set-context system:kube-controller-manager --cluster=kubernetes --user=system:kube-controller-manager --kubeconfig=kube-controller-manager.kubeconfig
#4.设置当前上下文
kubectl config use-context system:kube-controller-manager --kubeconfig=kube-controller-manager.kubeconfig
创建配置文件kube-controller-manager.conf
#master1上
cd /data/work
tee -a kube-controller-manager.conf <<'EOF'
KUBE_CONTROLLER_MANAGER_OPTS="--port=0 \
--secure-port=10252 \
--bind-address=127.0.0.1 \
--kubeconfig=/etc/kubernetes/kube-controller-manager.kubeconfig \
--service-cluster-ip-range=10.255.0.0/16 \
--cluster-name=kubernetes \
--cluster-signing-cert-file=/etc/kubernetes/ssl/ca.pem \
--cluster-signing-key-file=/etc/kubernetes/ssl/ca-key.pem \
--allocate-node-cidrs=true \
--cluster-cidr=10.0.0.0/16 \
--experimental-cluster-signing-duration=87600h \
--root-ca-file=/etc/kubernetes/ssl/ca.pem \
--service-account-private-key-file=/etc/kubernetes/ssl/ca-key.pem \
--leader-elect=true \
--feature-gates=RotateKubeletServerCertificate=true \
--controllers=*,bootstrapsigner,tokencleaner \
--horizontal-pod-autoscaler-use-rest-clients=true \
--horizontal-pod-autoscaler-sync-period=10s \
--tls-cert-file=/etc/kubernetes/ssl/kube-controller-manager.pem \
--tls-private-key-file=/etc/kubernetes/ssl/kube-controller-manager-key.pem \
--use-service-account-credentials=true \
--alsologtostderr=true \
--logtostderr=false \
--log-dir=/var/log/kubernetes \
--v=2"
EOF
#这里的--bind-address=127.0.0.1 ,绑定了本机IP而非网卡IP,官方在1.20之后是这样设计的,为了避免物理机上curl能访问到,更安全。
创建启动文件
#master1上
cd /data/work
tee -a kube-controller-manager.service << 'EOF'
[Unit]
Description=Kubernetes Controller Manager
Documentation=https://github.com/kubernetes/kubernetes
[Service]
EnvironmentFile=-/etc/kubernetes/kube-controller-manager.conf
ExecStart=/usr/local/bin/kube-controller-manager $KUBE_CONTROLLER_MANAGER_OPTS
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
启动服务
#master1上
cd /data/work
cp kube-controller-manager*.pem /etc/kubernetes/ssl/
cp kube-controller-manager.kubeconfig /etc/kubernetes/
cp kube-controller-manager.conf /etc/kubernetes/
cp kube-controller-manager.service /usr/lib/systemd/system/
rsync -vaz kube-controller-manager*.pem binmaster2:/etc/kubernetes/ssl/
rsync -vaz kube-controller-manager*.pem binmaster3:/etc/kubernetes/ssl/
rsync -vaz kube-controller-manager.kubeconfig kube-controller-manager.conf binmaster2:/etc/kubernetes/
rsync -vaz kube-controller-manager.kubeconfig kube-controller-manager.conf binmaster3:/etc/kubernetes/
rsync -vaz kube-controller-manager.service binmaster2:/usr/lib/systemd/system/
rsync -vaz kube-controller-manager.service binmaster3:/usr/lib/systemd/system/
#master1、2、3上
systemctl daemon-reload
systemctl enable kube-controller-manager
systemctl start kube-controller-manager
systemctl status kube-controller-manager
ss -antulp | grep 10252 #查看端口占用
部署kube-scheduler组件
创建csr请求
#master1上
cd /data/work
tee -a kube-scheduler-csr.json <<'EOF'
{
"CN": "system:kube-scheduler",
"hosts": [
"127.0.0.1",
"172.16.183.76",
"172.16.183.77",
"172.16.183.78",
"172.16.183.79"
],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "system:kube-scheduler",
"OU": "system"
}
]
}
EOF
- 证书请求文件让system:kube-scheduler这个用户被api-server信任,后面scheduler就能访问apiserver了,至于权限是由kubernetes 内置的 ClusterRoleBindings system:kube-scheduler 将赋予 kube-scheduler 工作所需的权限。
- hosts 列表包含所有 kube-scheduler 节点 IP; CN 为 system:kube-scheduler、O 为 system:kube-scheduler,
生成证书
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kube-scheduler-csr.json | cfssljson -bare kube-scheduler
创建kubeconfig
- 设置集群参数
kubectl config set-cluster kubernetes --certificate-authority=ca.pem --embed-certs=true --server=https://172.16.183.76:6443 --kubeconfig=kube-scheduler.kubeconfig
- 设置客户端认证参数
kubectl config set-credentials system:kube-scheduler --client-certificate=kube-scheduler.pem --client-key=kube-scheduler-key.pem --embed-certs=true --kubeconfig=kube-scheduler.kubeconfig
- 设置上下文参数
#上下文的名称随便起,但是用户和集群要写对,跟证书请求文件中一致
kubectl config set-context system:kube-scheduler --cluster=kubernetes --user=system:kube-scheduler --kubeconfig=kube-scheduler.kubeconfig
- 设置当前上下文
kubectl config use-context system:kube-scheduler --kubeconfig=kube-scheduler.kubeconfig
创建配置文件kube-scheduler.conf
tee -a kube-scheduler.conf <<'EOF'
KUBE_SCHEDULER_OPTS="--address=127.0.0.1 \
--kubeconfig=/etc/kubernetes/kube-scheduler.kubeconfig \
--leader-elect=true \
--alsologtostderr=true \
--logtostderr=false \
--log-dir=/var/log/kubernetes \
--v=2"
EOF
#kube-scheduler.kubeconfig里面已经指定了apiserver地址以及证书。
创建服务启动文件
tee -a kube-scheduler.service <<'EOF'
[Unit]
Description=Kubernetes Scheduler
Documentation=https://github.com/kubernetes/kubernetes
[Service]
EnvironmentFile=-/etc/kubernetes/kube-scheduler.conf
ExecStart=/usr/local/bin/kube-scheduler $KUBE_SCHEDULER_OPTS
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
启动服务
#master1上
cp kube-scheduler*.pem /etc/kubernetes/ssl/
cp kube-scheduler.kubeconfig /etc/kubernetes/
cp kube-scheduler.conf /etc/kubernetes/
cp kube-scheduler.service /usr/lib/systemd/system/
rsync -vaz kube-scheduler*.pem binmaster2:/etc/kubernetes/ssl/
rsync -vaz kube-scheduler*.pem binmaster3:/etc/kubernetes/ssl/
rsync -vaz kube-scheduler.kubeconfig kube-scheduler.conf binmaster2:/etc/kubernetes/
rsync -vaz kube-scheduler.kubeconfig kube-scheduler.conf binmaster3:/etc/kubernetes/
rsync -vaz kube-scheduler.service binmaster2:/usr/lib/systemd/system/
rsync -vaz kube-scheduler.service binmaster3:/usr/lib/systemd/system/
#master 1、2、3上
systemctl daemon-reload
systemctl enable kube-scheduler
systemctl start kube-scheduler
systemctl status kube-scheduler
导入coredns镜像包
#把pause-cordns.tar.gz上传到node1节点,手动解压。pause和coredns是工作节点调度创建pod需要用到。
docker load -i pause-cordns.tar.gz
部署kubelet组件
- kubelet: 每个Node节点上的kubelet定期就会调用API Server的REST接口报告自身状态,API Server接收这些信息后,将节点状态信息更新到etcd中。kubelet也通过API Server监听Pod信息,从而对Node机器上的POD进行管理,如创建、删除、更新Pod。
- master节点上不需要调度pod,所以不需要安装kubelet
配置bootstrap token
#在master1上
cd /data/work/
BOOTSTRAP_TOKEN=$(awk -F "," '{print $1}' /etc/kubernetes/token.csv)
kubectl config set-cluster kubernetes --certificate-authority=ca.pem --embed-certs=true --server=https://172.16.183.76:6443 --kubeconfig=kubelet-bootstrap.kubeconfig
kubectl config set-credentials kubelet-bootstrap --token=${BOOTSTRAP_TOKEN} --kubeconfig=kubelet-bootstrap.kubeconfig
kubectl config set-context default --cluster=kubernetes --user=kubelet-bootstrap --kubeconfig=kubelet-bootstrap.kubeconfig
kubectl config use-context default --kubeconfig=kubelet-bootstrap.kubeconfig
kubectl create clusterrolebinding kubelet-bootstrap --clusterrole=system:node-bootstrapper --user=kubelet-bootstrap
创建配置文件kubelet.json
- "cgroupDriver": "systemd"要和docker的驱动一致。
- address替换为各个worker节点的IP地址。
tee -a kubelet.json <<'EOF'
{
"kind": "KubeletConfiguration",
"apiVersion": "kubelet.config.k8s.io/v1beta1",
"authentication": {
"x509": {
"clientCAFile": "/etc/kubernetes/ssl/ca.pem"
},
"webhook": {
"enabled": true,
"cacheTTL": "2m0s"
},
"anonymous": {
"enabled": false
}
},
"authorization": {
"mode": "Webhook",
"webhook": {
"cacheAuthorizedTTL": "5m0s",
"cacheUnauthorizedTTL": "30s"
}
},
"address": "172.16.183.79",
"port": 10250,
"readOnlyPort": 10255,
"cgroupDriver": "systemd",
"hairpinMode": "promiscuous-bridge",
"serializeImagePulls": false,
"featureGates": {
"RotateKubeletClientCertificate": true,
"RotateKubeletServerCertificate": true
},
"clusterDomain": "cluster.local.",
"clusterDNS": ["10.255.0.2"]
}
EOF
创建kubelet服务启动文件
tee -a kubelet.service <<'EOF'
[Unit]
Description=Kubernetes Kubelet
Documentation=https://github.com/kubernetes/kubernetes
After=docker.service
Requires=docker.service
[Service]
WorkingDirectory=/var/lib/kubelet
ExecStart=/usr/local/bin/kubelet \
--bootstrap-kubeconfig=/etc/kubernetes/kubelet-bootstrap.kubeconfig \ #这个config是为了kubelet第一次和apiserver通信的时候自动生成证书保存到下面的目录里面
--cert-dir=/etc/kubernetes/ssl \
--kubeconfig=/etc/kubernetes/kubelet.kubeconfig \
--config=/etc/kubernetes/kubelet.json \
--network-plugin=cni \
--pod-infra-container-image=k8s.gcr.io/pause:3.2 \
--alsologtostderr=true \
--logtostderr=false \
--log-dir=/var/log/kubernetes \
--v=2
#如果1.24以上用containerd作为容器运行时,加这个参数
--container-runtime-endpoint=unix:///run/containerd/containerd.sock
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
- kubelet 启动时实际需要指定两个配置⽂件
- --kubeconfig 指定的是kube-config ⽂件,其中内置了集群根CA 公钥以及⾃⼰作为客户端的公钥和私钥
- --config 指定的是kubelet的配置
#node1上
mkdir /etc/kubernetes/ssl -p
#master1上
scp kubelet-bootstrap.kubeconfig kubelet.json binnode1:/etc/kubernetes/
scp ca.pem binnode1:/etc/kubernetes/ssl/
scp kubelet.service binnode1:/usr/lib/systemd/system/
启动kubelet服务
#node1上
mkdir /var/lib/kubelet
mkdir /var/log/kubernetes
systemctl daemon-reload
systemctl enable kubelet
systemctl start kubelet
systemctl status kubelet
#确认kubelet服务启动成功后,接着到binmaster1节点上Approve一下bootstrap请求
#执行如下命令可以看到一个worker节点发送了一个 CSR 请求:
kubectl get csr
kubectl certificate approve node-csr-xxxx
kubectl get nodes
#会显示binnode1的notready状态,是因为还未安装网络插件。kubelet暂时不能与apiserver通信
部署kube-proxy组件
创建csr请求
#在master1上
cd /data/work/
tee -a kube-proxy-csr.json <<'EOF'
{
"CN": "system:kube-proxy",
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "Hubei",
"L": "Wuhan",
"O": "k8s",
"OU": "system"
}
]
}
EOF
生成证书
#在master1上
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kube-proxy-csr.json | cfssljson -bare kube-proxy
创建kubeconfig文件
#在master1上
kubectl config set-cluster kubernetes --certificate-authority=ca.pem --embed-certs=true --server=https://172.16.183.76:6443 --kubeconfig=kube-proxy.kubeconfig
kubectl config set-credentials kube-proxy --client-certificate=kube-proxy.pem --client-key=kube-proxy-key.pem --embed-certs=true --kubeconfig=kube-proxy.kubeconfig
kubectl config set-context default --cluster=kubernetes --user=kube-proxy --kubeconfig=kube-proxy.kubeconfig
kubectl config use-context default --kubeconfig=kube-proxy.kubeconfig
创建kube-proxy配置文件
#在master1上
tee -a kube-proxy.yaml <<'EOF'
apiVersion: kubeproxy.config.k8s.io/v1alpha1
bindAddress: 172.16.183.79
clientConnection:
kubeconfig: /etc/kubernetes/kube-proxy.kubeconfig
clusterCIDR: 172.16.183.0/24
healthzBindAddress: 172.16.183.79:10256
kind: KubeProxyConfiguration
metricsBindAddress: 172.16.183.79:10249
mode: "ipvs"
EOF
创建服务启动文件
#在master1上
tee -a kube-proxy.service <<'EOF'
[Unit]
Description=Kubernetes Kube-Proxy Server
Documentation=https://github.com/kubernetes/kubernetes
After=network.target
[Service]
WorkingDirectory=/var/lib/kube-proxy
ExecStart=/usr/local/bin/kube-proxy \
--config=/etc/kubernetes/kube-proxy.yaml \
--alsologtostderr=true \
--logtostderr=false \
--log-dir=/var/log/kubernetes \
--v=2
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
EOF
scp kube-proxy.kubeconfig kube-proxy.yaml binnode1:/etc/kubernetes/
scp kube-proxy.service binnode1:/usr/lib/systemd/system/
启动服务
#node1上
mkdir -p /var/lib/kube-proxy
systemctl daemon-reload
systemctl enable kube-proxy
systemctl start kube-proxy
systemctl status kube-proxy
部署calico组件
#上传calico镜像,calico.tar.gz上传到node1节点,手动解压。calico pod运行在工作节点
docker load -i calico.tar.gz
#把calico.yaml文件上传到master1上的的/data/work目录
kubectl apply -f calico.yaml
部署coredns组件
#上传coredns.yaml到master1
kubectl apply -f coredns.yaml
#测试coredns
kubectl run busybox --image busybox:1.28 --restart=Never --rm -it busybox -- sh
ping www.baidu.com
nslookup kubernetes.default.svc.cluster.local #解析内部Service的名称,是通过coreDNS去解析的。
keepalived+nginx实现apiserver高可用
准备epel.repo
#把epel.repo上传到binmaster1的/etc/yum.repos.d目录下.
scp /etc/yum.repos.d/epel.repo binmaster2:/etc/yum.repos.d/
scp /etc/yum.repos.d/epel.repo binmaster3:/etc/yum.repos.d/
scp /etc/yum.repos.d/epel.repo binnode1:/etc/yum.repos.d/
#安装nginx主备
#在master1和master2上做nginx主备安装
yum install nginx keepalived -y
修改nginx配置文件
#在master1和master2上,修改nginx配置文件。主备一样
mkdir -p /etc/nginx/
tee /etc/nginx/nginx.conf <<'EOF'
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
include /usr/share/nginx/modules/*.conf;
events {
worker_connections 1024;
}
# 四层负载均衡,为两台Master apiserver组件提供负载均衡
stream {
log_format main '$remote_addr $upstream_addr - [$time_local] $status $upstream_bytes_sent';
access_log /var/log/nginx/k8s-access.log main;
upstream k8s-apiserver {
server 172.16.183.76:6443; # binmaster1 APISERVER IP:PORT
server 172.16.183.77:6443; # binmaster2 APISERVER IP:PORT
server 172.16.183.78:6443; # binmaster3 APISERVER IP:PORT
}
server {
listen 16443; # 由于nginx与master节点复用,这个监听端口不能是6443,否则会冲突。访问master1的16443端口,请求会被代理到upstream的3台节点
proxy_pass k8s-apiserver;
}
}
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
include /etc/nginx/mime.types;
default_type application/octet-stream;
server {
listen 80 default_server;
server_name _;
location / {
}
}
}
EOF
修改keepalived配置文件
主keepalived节点
#主keepalived配置 - keepalived主要用来提供VIP
mkdir -p /etc/keepalived/
tee /etc/keepalived/keepalived.conf <<'EOF'
global_defs {
notification_email {
acassen@firewall.loc
failover@firewall.loc
sysadmin@firewall.loc
}
notification_email_from Alexandre.Cassen@firewall.loc
smtp_server 127.0.0.1
smtp_connect_timeout 30
router_id NGINX_MASTER
}
vrrp_script check_nginx {
script "/etc/keepalived/check_nginx.sh"
}
vrrp_instance VI_1 {
state MASTER
interface ens33 # 修改为实际网卡名
virtual_router_id 51 # VRRP 路由 ID实例,每个实例是唯一的
priority 100 # 优先级,备服务器设置 90
advert_int 1 # 指定VRRP 心跳包通告间隔时间,默认1秒
authentication {
auth_type PASS
auth_pass 1111
}
# 虚拟IP
virtual_ipaddress {
172.16.183.75/24
}
track_script {
check_nginx
}
}
EOF
#vrrp_script:指定检查nginx工作状态脚本(根据nginx状态判断是否故障转移)
#virtual_ipaddress:虚拟IP(VIP)
#master1上
cd ~
tee /etc/keepalived/check_nginx.sh <<'EOF'
#!/bin/bash
count=$(ps -ef |grep nginx | grep sbin | egrep -cv "grep|$$")
if [ "$count" -eq 0 ];then
systemctl stop keepalived
fi
EOF
chmod +x /etc/keepalived/check_nginx.sh
备keepalived节点
tee /etc/keepalived/keepalived.conf <<'EOF'
global_defs {
notification_email {
acassen@firewall.loc
failover@firewall.loc
sysadmin@firewall.loc
}
notification_email_from Alexandre.Cassen@firewall.loc
smtp_server 127.0.0.1
smtp_connect_timeout 30
router_id NGINX_BACKUP
}
vrrp_script check_nginx {
script "/etc/keepalived/check_nginx.sh"
}
vrrp_instance VI_1 {
state BACKUP
interface ens33
virtual_router_id 51 # VRRP 路由 ID实例,每个实例是唯一的
priority 90
advert_int 1
authentication {
auth_type PASS
auth_pass 1111
}
virtual_ipaddress {
172.16.183.75/24
}
track_script {
check_nginx
}
}
EOF
#master2上
cd ~
cat /etc/keepalived/check_nginx.sh
#!/bin/bash
count=$(ps -ef |grep nginx | grep sbin | egrep -cv "grep|$$")
if [ "$count" -eq 0 ];then
systemctl stop keepalived
fi
chmod +x /etc/keepalived/check_nginx.sh
#注:keepalived根据脚本返回状态码(0为工作正常,非0不正常)判断是否故障转移。当nginx服务出现故障时,自动停止keepalived服务,触发故障切换。VIP就会切走。
启动服务
#master1和2上
systemctl daemon-reload
yum install nginx-mod-stream -y
systemctl start nginx
systemctl start keepalived
systemctl enable nginx keepalived
- 测试keepalived工作:stop掉master1上的nginx,vip会漂移到master2上
service stop nginx
配置worker节点与master的连接
#目前所有的Worker Node组件连接都还是master1 Node,如果不改为连接VIP走负载均衡器,那么Master还是单点故障。
#因此接下来就是要改所有Worker Node(kubectl get node命令查看到的节点)组件配置文件,由原来172.16.183.76修改为172.16.183.75(VIP)。
#在所有Worker Node执行:
sed -i 's#172.16.183.76:6443#172.16.183.75:16443#' /etc/kubernetes/kubelet-bootstrap.kubeconfig
sed -i 's#172.16.183.76:6443#172.16.183.75:16443#' /etc/kubernetes/kubelet.json
sed -i 's#172.16.183.76:6443#172.16.183.75:16443#' /etc/kubernetes/kubelet.kubeconfig
sed -i 's#172.16.183.76:6443#172.16.183.75:16443#' /etc/kubernetes/kube-proxy.yaml
sed -i 's#172.16.183.76:6443#172.16.183.75:16443#' /etc/kubernetes/kube-proxy.kubeconfig
systemctl restart kubelet kube-proxy
?question:不是有3台master节点吗?VIP漂移只发生在两个master上?master3是否也要设置为备用节点? 不需要,k8s组件请求apiserver的时候走的是VIP+16443端口,也就是nginx,nginx配置中已经将请求代理给了upstream的3台master。
二进制组件升级
下载二进制包
- 二进制包所在的github地址如下:Kubernetes CHANGELOG,可以按照版本下载二进制包。控制节点组件,找到Server Binaries,下载amd64版本的。server binaries二进制包里面就包含了:controller-manager,apiserver,scheduler等控制平面组件。其实也包含了工作节点需要的kubelet和kubeproxy
master节点升级
- 备份二进制文件
cd /usr/bin
mv kubectl kubectl.bak
systemctl stop kube-apiserver
systemctl stop kube-scheduler
systemctl stop kube-controller-manager
mv kube-apiserver kube-apiserver.bak
mv kube-controller-manager kube-controller-manager.bak
mv kube-scheduler kube-scheduler.bak
- 升级
tar xf kubernetes-server-linux-amd64.tar.gz
cp kubernetes/server/bin/kubectl /usr/bin/
cp kubernetes/server/bin/{kube-apiserver,kube-controller-manager,kube-scheduler} /usr/bin/
- 启动服务
systemctl start kube-apiserver
systemctl start kube-controller-manager
systemctl start kube-scheduler
如果升级完某些服务起不来,有可能是因为配置文件某些参数并不支持。可以查看服务状态中的报错:
systemctl status kube-apiserver -l
工作节点升级
- 备份二进制文件
systemctl stop kubelet
systemctl stop kube-proxy
cd /usr/bin
mv kubelet kubelet.bak
mv kube-proxy kube-proxy.bak
- 升级
#回到控制节点,把二进制文件分发到node节点
scp kubernetes/server/bin/{kubelet,kube-proxy} node:/usr/bin/
- 启动服务
systemctl daemon-reload && systemctl start kubelet
systemctl daemon-reload && systemctl start kube-proxy
二进制安装多master集群-1.25
环境准备
-
机器规划
-
podSubnet(pod网段) 10.244.0.0/16
- serviceSubnet(service网段): 10.96.0.0/12
- 操作系统:centos7.9
- 配置: 4Gib内存/4vCPU/60G硬盘
- 网络:NAT模式
| K8S集群角色 | IP | 主机名 | 安装的组件 |
|---|---|---|---|
| 控制节点 | 192.168.40.180 | xianchaomaster1 | apiserver、controller-manager、schedule、etcd、kube-proxy、容器运行时、keepalived、nginx |
| 控制节点 | 192.168.40.181 | xianchaomaster2 | apiserver、controller-manager、schedule、etcd、kube-proxy、容器运行时、keepalived、nginx |
| 控制节点 | 192.168.40.182 | xianchaomaster3 | apiserver、controller-manager、schedule、etcd、kube-proxy、容器运行时、keepalived、nginx |
| 工作节点 | 192.168.40.183 | xianchaonode1 | Kube-proxy、calico、coredns、容器运行时、kubelet |
| VIP | 192.168.40.199 |
-
配置静态IP
-
关闭selinux
-
配置机器主机名
-
配置hosts文件
-
配置时间同步
-
安装基础软件包
-
配置ssh互信
-
关闭swap分区
-
开启内核转发
-
关闭firewalld防火墙
-
配置aliyun repo源
#docker repo源
yum install yum-utils -y
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
#containerd repo源
#k8s repo源
#containerd repo源
containerd repo源
安装containerd
#所有节点安装
yum install containerd.io-1.6.6 -y
mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml
vim /etc/containerd/config.toml
#把SystemdCgroup = false修改成SystemdCgroup = true
#把sandbox_image = "k8s.gcr.io/pause:3.6"修改sandbox_image="registry.aliyuncs.com/google_containers/pause:3.7"
systemctl enable containerd --now
- 配置containerd镜像加速器
vim /etc/containerd/config.toml文件
#找到config_path = "",修改成如下目录:config_path = "/etc/containerd/certs.d"
mkdir /etc/containerd/certs.d/docker.io/ -p
vim /etc/containerd/certs.d/docker.io/hosts.toml
#写入如下内容:
[host."https://docker.m.daocloud.io"]
capabilities = ["pull"]
#重启containerd:
systemctl restart containerd
安装crictl
- 安装包可以从这里下载:cri-tools releases
#所有节点
wget https://github.com/kubernetes-sigs/cri-tools/releases/download/v1.24.2/crictl-v1.24.2-linux-amd64.tar.gz
tar zxvf crictl-v1.24.2-linux-amd64.tar.gz -C /usr/bin/
cat > /etc/crictl.yaml <<EOF
runtime-endpoint: unix:///run/containerd/containerd.sock
image-endpoint: unix:///run/containerd/containerd.sock
timeout: 10
debug: false
EOF
systemctl restart containerd
安装docker
#所有节点
yum install docker-ce -y
systemctl enable docker --now
- 配置加速器
#配置docker镜像加速器,k8s所有节点均按照以下配置
vim /etc/docker/daemon.json
#写入如下内容:
{
"registry-mirrors":["https://docker.m.daocloud.io"]
}
#重启docker:
systemctl restart docker
搭建etcd集群
同上面1.20.7
安装k8s组件
同上面1.20.7
-
注:镜像解压用ctr -n=k8s.io images import
-
最后多一步:对系统用户kubernetes做授权
kubectl create clusterrolebinding kubernetes-kubectl --clusterrole=cluster-admin --user=kubernetes