KubeKey 3.1.1踩坑指南：Ubuntu 24.04系统下的K8s 1.29.2离线安装全记录

原创

于 2026-02-24 05:58:24 发布 · 454 阅读

标签

#KubeKey #Kubernetes #离线安装 #高可用集群

KubeKey 3.1.1实战：Ubuntu 24.04系统下K8s 1.29.2离线部署深度解析

1. 环境规划与准备

在开始部署之前，我们需要对整体环境进行详细规划。Ubuntu 24.04作为最新的LTS版本，与Kubernetes 1.29.2的组合需要特别注意系统依赖和版本兼容性问题。

1.1 硬件资源规划

建议的最低配置要求：

控制平面节点：4核CPU/8GB内存/100GB存储
工作节点：8核CPU/16GB内存/200GB存储
负载均衡节点：2核CPU/4GB内存/50GB存储

实际生产环境中，建议根据工作负载适当提高配置。我们本次部署采用4节点架构：

节点类型	主机名	IP地址	角色分配
主节点	k8smaster-lv01	10.0.0.130	etcd, control-plane
工作节点	k8snode-lv01	10.0.0.131	worker, etcd
工作节点	k8snode-lv02	10.0.0.132	worker, etcd
工作节点	k8snode-lv03	10.0.0.133	worker
负载均衡节点	lb.kubesphere.local	10.0.0.140	keepalived+haproxy

1.2 系统基础配置

在所有节点上执行以下基础配置：

# 禁用swap
sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab

# 设置时间同步
sudo timedatectl set-timezone Asia/Shanghai
sudo systemctl enable --now chronyd

# 加载内核模块
sudo modprobe overlay
sudo modprobe br_netfilter

# 设置内核参数
cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
EOF
sudo sysctl --system