全网最细，RHEL9 搭建 Kubernetes v1.26.5 3节点集群

前言：本文基于 Red Hat Enterprise Linux 9（RHEL9）系统，结合实测经验，梳理出真正可行的 Kubernetes v1.26.5 3 节点集群搭建流程，节点 IP 固定为 192.168.38.147（master）、192.168.38.148（work1）、192.168.38.149（work2）。适配后续 Prometheus 监控部署（含本地持久化目录、节点亲和性等前置配置），步骤清晰可直接复制执行，适合运维新手入门实操。

一、环境规划（固定配置，与 Prometheus 实验环境完全匹配）

表格

补充：K8s 版本固定为 v1.26.5，与后续部署的 Prometheus 版本适配。

二、前置准备（所有节点通用，必做）

所有 3 台节点均需执行以下操作，确保环境一致性，避免后续集群启动失败，每一步均可行。

2.1 硬件配置

（1）k8smaster（控制节点）CPU：2 核内存：4GB（必须 4G，2G 经常爆 swap）硬盘：40G

（2）k8swork1（工作节点）CPU：2 核内存：4GB硬盘：40G

（3）k8swork2（工作节点，跑 Prometheus/Grafana）CPU：2 核内存：4GB硬盘：60G（要存监控数据）

2.2 设置主机名（严格对应规划，避免后续报错）

分别在 3 台节点执行对应命令，设置主机名并永久生效：

# 192.168.38.147（master节点）执行
hostnamectl set-hostname k8smaster

# 192.168.38.148（work1节点）执行
hostnamectl set-hostname k8swork1

# 192.168.38.149（work2节点）执行
hostnamectl set-hostname k8swork2

执行完成后，可通过 hostname 命令验证。

2.3 配置 hosts 解析（所有节点）

cat >> /etc/hosts <<EOF
192.168.38.147 k8smaster
192.168.38.148 k8swork1
192.168.38.149 k8swork2
EOF

验证：ping k8smaster、ping k8swork1、ping k8swork2 互通。

2.4 关闭防火墙、SELinux、Swap（关键步骤）

# 关闭防火墙（永久禁用）
systemctl stop firewalld
systemctl disable firewalld

# 关闭SELinux（临时+永久）
setenforce 0
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

# 关闭Swap（临时+永久，K8s强制要求）
swapoff -a
sed -i '/swap/s/^/#/' /etc/fstab

验证：getenforce 输出 Permissive，free -h Swap 为 0。

2.5 配置内核模块与网络转发

# 加载内核模块
modprobe overlay
modprobe br_netfilter

# 配置内核参数，永久生效
cat > /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-iptables = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward = 1
EOF

# 生效内核参数
sysctl -p /etc/sysctl.d/k8s.conf

2.6 安装 containerd（RHEL9 专用正确源）

# 安装依赖
dnf install -y ca-certificates curl gnupg

# 配置阿里云 containerd 源（适配RHEL9，不兼容centos7源）
cat > /etc/yum.repos.d/docker-ce.repo <<EOF
[docker-ce-stable]
name=Docker CE Stable – \\$basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/rhel/\\$releasever/\\$basearch/stable
enabled=1
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/rhel/gpg
EOF

# 安装 containerd
dnf install -y containerd
systemctl enable –now containerd

2.7 配置 containerd（关键，cgroup + 镜像源 + 加速器）

# 生成默认配置
containerd config default > /etc/containerd/config.toml

# 设置 systemd cgroup
sed -i 's/SystemdCgroup \\= false/SystemdCgroup \\= true/' /etc/containerd/config.toml

# 替换k8s镜像源为阿里云
sed -i 's#registry.k8s.io#registry.aliyuncs.com/google_containers#' /etc/containerd/config.toml

# 配置docker.io镜像加速器（后续Prometheus必备）
sed -i 's|https://registry-1.docker.io|https://docker.mirrors.ustc.edu.cn|' /etc/containerd/config.toml

# 重启生效
systemctl restart containerd

2.8 安装 kubeadm、kubelet、kubectl（固定 v1.26.5）

# 阿里云K8s源
cat > /etc/yum.repos.d/kubernetes.repo <<EOF
[kubernetes]
name=Kubernetes
baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
EOF

# 安装固定版本
dnf install -y kubelet-1.26.5 kubeadm-1.26.5 kubectl-1.26.5

# 只设置开机自启，**不要手动启动kubelet**，初始化后自动启动
systemctl enable kubelet

三、控制节点（k8smaster）操作

3.1 初始化 K8s 集群（核心步骤）

kubeadm init \\
–kubernetes-version=1.26.5 \\
–apiserver-advertise-address=192.168.38.147 \\
–image-repository=registry.aliyuncs.com/google_containers \\
–pod-network-cidr=10.244.0.0/16

出现 Your Kubernetes control-plane has initialized successfully! 即成功。

3.2 配置 kubectl 权限

mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config

验证：kubectl get nodes 此时 master 为 NotReady（正常，缺网络插件）。

3.3 安装 Flannel 网络插件

kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml

监控：

kubectl get pods -n kube-flannel -w

所有 kube‑flannel‑ds 状态 Running 即正常。

3.4 解除 master 节点污点（Prometheus 部署必须加）

允许 master 调度 Pod，否则监控组件不能部署在 master：

kubectl taint nodes k8smaster node-role.kubernetes.io/control-plane-

3.5 生成 worker 永久加入命令

kubeadm token create –print-join-command

复制输出的 kubeadm join 命令备用。

四、工作节点（k8swork1、k8swork2）操作

两台节点执行相同命令：

kubeadm join 192.168.38.147:6443 –token xxx –discovery-token-ca-cert-hash sha256:xxx

加入失败执行：

systemctl restart kubelet

五、集群验证（master 执行）

# 查看所有节点，全部Ready即成功
kubectl get nodes

# 查看flannel状态
kubectl get pods -n kube-flannel

# 查看集群核心组件
kubectl get cs

六、常见问题排查（补充完善）

flannel 无法启动

mkdir -p /etc/cni/net.d
cat > /etc/cni/net.d/10-flannel.conflist <<EOF
{
"cniVersion": "0.3.1",
"name": "cbr0",
"plugins": [
{
"type": "flannel",
"delegate": {
"hairpinMode": true,
"isDefaultGateway": true
}
},
{
"type": "portmap",
"capabilities": {
"portMappings": true
}
}
]
}
EOF

kube‑apiserver 异常

systemctl status kube-apiserver
journalctl -u kubelet -f

节点 NotReady

systemctl restart kubelet
kubectl describe node 节点名

七、总结

本文基于 RHEL9 系统搭建 K8s v1.26.5 3 节点集群的完整流程。从环境初始化、组件安装，到集群初始化、节点加入，再到 Prometheus 适配配置，每一步都经过验证，新手可直接复制执行。若操作过程中遇到其他问题，可排查日志或网络问题。