Code Guide

外观

2、kubeadm初始化集群

约 2564 字大约 9 分钟

2025-09-04

kubeadm初始化集群

1 kubeadm介绍

kubeadm是Kubernetes项目自带的集群构建工具，负责执行构建一个最小化的可用集群以及将其启动等的必要基本步骤，kubeadm是Kubernetes集群全生命周期的管理工具，可用于实现集群的部署、升级、降级及拆除。kubeadm部署Kubernetes集群是将大部分资源以pod的方式运行，例如（kube-proxy、kube-controller-manager、kube-scheduler、kube-apiserver、flannel)都是以pod方式运行。

Kubeadm仅关心如何初始化并启动集群，余下的其他操作，例如安装Kubernetes Dashboard、监控系统、日志系统等必要的附加组件则不在其考虑范围之内，需要管理员自行部署。

Kubeadm集成了Kubeadm init和kubeadm join等工具程序，其中kubeadm init用于集群的快速初始化，其核心功能是部署Master节点的各个组件，而kubeadm join则用于将节点快速加入到指定集群中，它们是创建Kubernetes集群最佳实践的“快速路径”。另外，kubeadm token可于集群构建后管理用于加入集群时使用的认证令牌（token)，而kubeadm reset命令的功能则是删除集群构建过程中生成的文件以重置回初始状态。

kubeadm项目地址

kubeadm官方文档

2 Kubeadm部署Kubernetes集群

2.1 架构图

img

2.2 环境规划

操作系统IPCPU/Mem主机名角色
CentOS7.4-86_x64192.168.1.312/2Gk8s-masterMaster
CentOS7.4-86_x64192.168.1.322/2Gk8s-node1Node
CentOS7.4-86_x64192.168.1.332/2Gk8s-node2Node
nameversion
Docker18.09.7
kubeadm1.15.2
kubelet1.15.2
kubectl1.15.2

说明：下面初始化环境工作master节点和node节点都需要执行

1）关闭防火墙

# systemctl stop firewalld
# systemctl disable firewalld

2）关闭selinux

# sed -i 's/enforcing/disabled/' /etc/selinux/config
# setenforce 0

3）如需要关闭swap，（由于服务器本来配置就低，这里就不关闭swap，在后面部署过程中忽略swap报错即可）

# swapoff -a  #临时
# vim /etc/fstab    #永久

4）时间同步

# ntpdate 0.rhel.pool.ntp.org

5）host绑定

# vim /etc/hosts
192.168.1.31	k8s-master
192.168.1.32	k8s-node1
192.168.1.33	k8s-node2

2.3 安装docker

master节点和所有node节点都需要执行

1）配置docker的yum仓库（这里使用阿里云仓库）

# yum -y install yum-utils device-mapper-persistent-data lvm2
# yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

2）安装docker

# yum -y install docker-ce-18.09.7 docker-ce-cli-18.09.7 containerd.io

3）修改docker cgroup driver为systemd

根据文档CRI installation中的内容，对于使用systemd作为init system的Linux的发行版，使用systemd作为docker的cgroup driver可以确保服务器节点在资源紧张的情况更加稳定，因此这里修改各个节点上docker的cgroup driver为systemd。

# mkdir /etc/docker    #没启动docker之前没有该目录
# vim /etc/docker/daemon.json    #如果不存在则创建
{
  "exec-opts": ["native.cgroupdriver=systemd"]
}

4）启动docker

# systemctl restart docker    #启动docker
# systemctl enable docker    #开机自启动

# docker info |grep Cgroup
Cgroup Driver: systemd

2.4 安装kubeadm

master节点和所有node节点都需要执行

1）配置kubenetes的yum仓库（这里使用阿里云仓库）

2）安装kubelat、kubectl、kubeadm

# yum -y install kubelet-1.15.2 kubeadm-1.15.2 kubectl-1.15.2

# rpm -aq kubelet kubectl kubeadm
kubectl-1.15.2-0.x86_64
kubelet-1.15.2-0.x86_64
kubeadm-1.15.2-0.x86_64

3）将kubelet加入开机启动，这里刚安装完成不能直接启动。（因为目前还没有集群还没有建立）

# systemctl enable kubelet

2.5 初始化Master

注意：在master节点执行

通过kubeadm --help帮助手册可以看到可以通过kubeadm init初始化一个master节点，然后再通过kubeadm join将一个node节点加入到集群中。

1）配置忽略swap报错

[root@k8s-master ~]# vim /etc/sysconfig/kubelet
KUBELET_EXTRA_ARGS="--fail-swap-on=false"

2）初始化master

--kubernetes-version    #指定Kubernetes版本
--image-repository   #由于kubeadm默认是从官网k8s.grc.io下载所需镜像，国内无法访问，所以这里通过--image-repository指定为阿里云镜像仓库地址
--pod-network-cidr    #指定pod网络段
--service-cidr    #指定service网络段
--ignore-preflight-errors=Swap    #忽略swap报错信息

3）按照上面初始化成功提示创建配置文件

[root@k8s-master ~]# mkdir -p $HOME/.kube
[root@k8s-master ~]# cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
[root@k8s-master ~]# chown $(id -u):$(id -g) $HOME/.kube/config
[root@k8s-master ~]# docker image ls   #初始化完成后可以看到所需镜像也拉取下来了
REPOSITORY                                                        TAG                 IMAGE ID            CREATED             SIZE
registry.aliyuncs.com/google_containers/kube-scheduler            v1.15.2             88fa9cb27bd2        2 weeks ago         81.1MB
registry.aliyuncs.com/google_containers/kube-proxy                v1.15.2             167bbf6c9338        2 weeks ago         82.4MB
registry.aliyuncs.com/google_containers/kube-apiserver            v1.15.2             34a53be6c9a7        2 weeks ago         207MB
registry.aliyuncs.com/google_containers/kube-controller-manager   v1.15.2             9f5df470155d        2 weeks ago         159MB
registry.aliyuncs.com/google_containers/coredns                   1.3.1               eb516548c180        7 months ago        40.3MB
registry.aliyuncs.com/google_containers/etcd                      3.3.10              2c4adeb21b4f        8 months ago        258MB
registry.aliyuncs.com/google_containers/pause                     3.1                 da86e6ba6ca1        20 months ago       742kB

4）添加flannel网络组件 flannel项目地址

2.6 加入Node节点

向集群中添加新节点，执行在kubeadm init 输出的kubeadm join命令，再在后面同样添加忽略swap报错参数。

1）配置忽略swap报错

[root@k8s-node1 ~]# vim /etc/sysconfig/kubelet
KUBELET_EXTRA_ARGS="--fail-swap-on=false"

[root@k8s-node2 ~]# vim /etc/sysconfig/kubelet
KUBELET_EXTRA_ARGS="--fail-swap-on=false"

2）加入node1节点

3）加入node2节点

2.7 检查集群状态

1）在master节点输入命令检查集群状态，返回如下结果则集群状态正常

[root@k8s-master ~]# kubectl get nodes
NAME         STATUS     ROLES    AGE     VERSION
k8s-master   Ready      master   9m40s   v1.15.2
k8s-node1    NotReady   <none>   28s     v1.15.2
k8s-node2    NotReady   <none>   13s     v1.15.2

重点查看STATUS内容为Ready时，则说明集群状态正常。

2）查看集群客户端和服务端程序版本信息

[root@k8s-master ~]# kubectl version --short=true
Client Version: v1.15.2
Server Version: v1.15.2

3）查看集群信息

[root@k8s-master ~]# kubectl cluster-info
Kubernetes master is running at https://192.168.1.31:6443
KubeDNS is running at https://192.168.1.31:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

4）查看每个节点下载的镜像

2.8 删除节点

有时节点出现故障，需要删除节点，方法如下

1）在master节点上执行

# kubectl drain <NODE-NAME> --delete-local-data --force --ignore-daemonsets
# kubectl delete node <NODE-NAME>

2）在需要移除的节点上执行

# kubeadm reset

贡献者

codingLab

版权归属：codingLab

许可证：bugcode

Code Guide © 2020-2025