当前位置：首页 > news >正文

从零开始：使用 kubeadm 部署 Kubernetes 集群的详细指南

news 来源：原创 2025/8/22 7:40:54

使用kubeadmin 部署k8s集群

硬件要求

前期准备

Master

检查 API 服务器证书

清理并重新初始化

查 kubeadm 初始化日志

配置 crictl 的 endpoint

硬件要求

主机名 ip 硬件最低要求建议，跑的块

master 10.1.1.7 2核，2G 内存给个6G

node2 10.1.1.22 1核，1G 内存给个6G

node6 10.1.1.33 1核，1G 内存给个6G

前期准备

三台服务器上都要做的：

（1）修改主机名

hostnamectl set-hostname xxx

（2）为了避免做dns,在/etc/hosts 文件中记录主机名

vi /etc/hosts

3）关闭防火墙，安装iptables

systemctl stop firewalld

systemctl disable firewalld

安装iptables

yum -y install iptables-services

各节点启动

systemctl start iptables

清空规则

iptables -F

开机启动

systemctl enable iptables

(4)禁用selinux

setenforce 0

sed -i "s/SELINUX=enforcing/SELINUX=disabled/g" /etc/selinux/config

(5) 设置时区

timedatectl set-timezone Asia/Shanghai

关闭 swap 分区

sudo swapoff -a # 临时禁用

sudo sed -i '/ swap / s/^$.*$$/#\1/g' /etc/fstab # 永久禁用

(7) 安装 ipvs

yum install -y ipvsadm ipset

(8)加载 bridge

yum install -y epel-release

yum install -y bridge-utils

modprobe br_netfilter

echo 'br_netfilter' >> /etc/modules-load.d/bridge.conf

echo 'net.bridge.bridge-nf-call-iptables=1' >> /etc/sysctl.conf

echo 'net.bridge.bridge-nf-call-ip6tables=1' >> /etc/sysctl.conf

echo 'net.ipv4.ip_forward=1' >> /etc/sysctl.conf

sysctl -p

(9)添加 docker-ce yum 源

yum install -y yum-utils device-mapper-persistent-data lvm2

yum-config-manager--add-repohttps://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

sed -i 's+download.docker.com+mirrors.aliyun.com/docker-ce+' /etc/yum.repos.d/docker-ce.repo

(10)安装docker（27.3.1）

yum -y install docker-ce

注：不一定是这个版本，只是提醒一下，我们安装的docker 是高版本；

如果下面不想使用cri-docker ,安装的docker 版本不要高于20.10，因为kubeadm-1.23.6 不支持太高的

版本；

（11）配置 daemon.json 重要的是配置源

cat > /etc/docker/daemon.json <<EOF

{"data-root": "/data/docker","exec-opts": ["native.cgroupdriver=systemd"],"log-

driver":"json-file","log-opts":{"max-size": "100m","max-file": "100"},"registry-

mirrors":

["https://docker.m.daocloud.io","https://docker.hpcloud.cloud","https://docker.u

nsee.tech","https://docker.1panel.live","http://mirrors.ustc.edu.cn","https://do

cker.chenby.cn","http://mirror.azure.cn","https://dockerpull.org","https://docke

rhub.icu","https://hub.rat.dev"]}

EOF

(12) 重启docker服务

systemctl daemon-reload && systemctl restart docker && systemctl enable docker

(13) 安装 cri-docker

wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.9/cri-dockerd-0.3.9.amd64.tgz

tar -xf cri-dockerd-0.3.9.amd64.tgz

cp cri-dockerd/cri-dockerd /usr/bin/

chmod +x /usr/bin/cri-docker

配置cir-docker服务

创建docker.service.d文件

mkdir -p /etc/systemd/system/docker.service.d

vim /usr/lib/systemd/system/cri-docker.service

写入

[Unit]

Description=CRI Interface for Docker Application Container Engine

Documentation=https://docs.mirantis.com

After=network-online.target firewalld.service docker.service

Wants=network-online.target

Requires=cri-docker.socket

[Service]

Type=notify

ExecStart=/usr/bin/cri-dockerd--network-plugin=cni--pod-infra-container-image=registry.aliyuncs.com/google_containers/pause:3.8

ExecReload=/bin/kill -s HUP $MAINPID

TimeoutSec=0

RestartSec=2

Restart=always

StartLimitBurst=3

StartLimitInterval=60s

LimitNOFILE=infinity

LimitNPROC=infinity

LimitCORE=infinity

TasksMax=infinity

Delegate=yes

KillMode=process

[Install]

WantedBy=multi-user.target

修改格式

(15)添加cir-docker套接字

cat <<"EOF" > /usr/lib/systemd/system/cri-docker.socket

[Unit]

Description=CRI Docker Socket for the API

PartOf=cri-docker.service

[Socket]

ListenStream=%t/cri-dockerd.sock

SocketMode=0660

SocketUser=root

SocketGroup=docker

[Install]

WantedBy=sockets.target

EOF

(16)启动cir-docker对应服务

systemctl daemon-reload

systemctl enable cri-docker

systemctl start cri-docker

systemctl is-active cri-docker

(17)添加kubeadm yum源

cat << EOF > /etc/yum.repos.d/kubernetes.repo

[kubernetes]

name=Kubernetes

baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/

enabled=1

gpgcheck=1

repo_gpgcheck=1

gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg

https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg

EOF

(18)安装kubernetes 1.18.2

yum -y install kubelet kubeadm kubeadm

systemctl enable kubelet.service

报错

# 下载并导入

yum-key.gpg curl -O https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg rpm --import yum-key.gpg

# 下载并导入

rpm-package-key.gpg curl -O https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg rpm --import rpm-package-key.gpg

Master

修改kubeadm初始化文件（改为自己主机名）

vim init-config.yaml

拉取k8s需要的镜像

kubeadm config images list --config=init-config.yaml

kubeadm config images pull --config=init-config.yaml

注：如果下载镜像失败，尝试手动下载；举例如下：

ctr -n k8s.io images pull registry.aliyuncs.com/google_containers/kube-apiserver:v1.23.0

初始化k8s-master

kubeadm init --config=init-config.yaml

出现successfully则成功

如果在这里报错了

处理：

检查 API 服务器证书

如果 API 服务器未启动，可能是证书问题。尝试重新生成证书

sudo kubeadm init phase certs all --config=init-config.yaml

清理并重新初始化

如果以上步骤未解决问题，尝试彻底清理后重新初始化

sudo kubeadm reset --force

sudo rm -rf /etc/kubernetes /var/lib/kubelet

sudo kubeadm init --config=init-config.yaml

重新运行需要检查端口冲突

查 kubeadm 初始化日志

重新运行 kubeadm init 并捕获详细日志

sudo kubeadm init --config=init-config.yaml --v=5

还是报错, kubelet 仍无法自动拉取镜像

sudo vi /var/lib/kubelet/config.yaml

添加

imagePullProgressDeadline: 20m

registryPullQPS: 50

registryBurst: 100

重启kubelet

sudo systemctl restart kubelet

还是拉取不了镜像

使用压缩包

配置 crictl 的 endpoint

如果使用 crictl，需要指定正确的 endpoint。

编辑或创建 crictl 配置文件 /etc/crictl.yaml，内容如下（以 containerd 为例）：

runtime-endpoint: unix:///run/containerd/containerd.sock

image-endpoint: unix:///run/containerd/containerd.sock

timeout: 10

debug: false

[root@master~]# mkdir -p $HOME/.kube

[root@master~]# cp -i /etc/kubernetes/admin.conf $HOME/.kube/config

[root@master~]# chown $(id-u):$(id-g) $HOME/.kube/config

node 节点加入集群)(node1,node2 上操作)

kubeadm join 10.1.1.7:6443 --token abcdef.0123456789abcdef \ --discovery-token-ca-cert-hash sha256:4fe135645d8b62b6ce5ac608bfdc8d6a0b551744cf4b890e72c08797ce5baf9f \ --cri-socket unix:///var/run/cri-dockerd.sock

k8s master上查看节点

kub get node

前面已经提到，在初始化k8s-master时并没有网络相关配置，所以无法跟node节点通信，因此状态都是

安装flannel 网络（可选）推荐

wget -L https://github.com/flannel-io/flannel/releases/latest/download/kube-

flannel.yml

kubectl apply -f kube-flannel.yml

配置：

网络配置：确保 Network 字段与你的集群网络规划一致（例如 10.244.0.0/16 ）。

后端类型：默认是 vxlan ，如果需要高性能，可以改为 host-gw 或 udp 。

镜像版本：确保镜像版本与 Flannel 的发布版本一致。

如果需要自定义配置，可以修改文件中的相关字段。

安装calico网络（可选）

curl -L

https://raw.githubusercontent.com/projectcalico/calico/v3.26.3/manifests/calico-

typha.yaml -o calico.yaml

kubectl apply -f calico.yaml

ready状态则成功

（9）查看状态

[root@master gtest]# kubectl get nodes -o wide

[root@master gtest]# kubectl get pod -n kube-system

至此，通过Kubeadm快速安装Kubernetes集群已经完成。

Kubernetes 核心资源及作用

Kubernetes 通过声明式 API 定义资源，以下是常用资源类型：

资源类型	作用
Pod	最小的部署单元，包含一个或多个容器，共享网络和存储资源。
Deployment	管理 Pod 的副本数、滚动更新和回滚，确保应用高可用。
Service	提供稳定的网络端点（如 ClusterIP、NodePort），用于访问 Pod。
ConfigMap	存储非敏感的配置数据（如环境变量、配置文件），供 Pod 使用。
Secret	存储敏感数据（如密码、API 密钥），以加密形式保存。
PersistentVolume (PV)	定义集群中的存储资源（如 NFS、云存储），供 Pod 持久化数据。
PersistentVolumeClaim (PVC)	由 Pod 申请的存储请求，自动绑定到合适的 PV。
StatefulSet	管理有状态应用（如数据库），保证稳定的网络标识和顺序部署。
DaemonSet	确保所有节点（或特定节点）运行一个 Pod 副本（如日志收集、监控代理）。
Job	执行一次性任务（如数据处理），完成后 Pod 终止。
CronJob	周期性执行 Job（如定时备份）。

硬件要求

前期准备

Master

检查 API 服务器证书

清理并重新初始化

查 kubeadm 初始化日志

配置 crictl 的 endpoint

Kubernetes 核心资源及作用

相关文章：