统信UOS部署Kubernetes集群必须完成主机名解析、禁用firewalld/SELinux/Swap、加载overlay/br_netfilter等内核模块、配置sysctl网络参数、设置文件描述符与进程数上限、启用chrony时间同步,任一缺失均导致kubeadm init失败或kubelet反复重启。

在统信UOS上配置Kubernetes集群节点,必须完成主机名解析、系统服务禁用、内核参数调优、模块加载和资源限制等硬性前置操作,任意一项缺失都会导致kubeadm init失败或kubelet反复重启。
基础环境统一配置(所有节点执行)
第一步:关闭防火墙与SELinux
执行 systemctl disable --now firewalld → 若系统使用ufw则运行 ufw disable。
【关键前提】SELinux必须永久禁用,否则kubelet无法挂载容器卷,且临时禁用后重启即失效:setenforce 0 → sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config。
第二步:彻底禁用Swap
临时关闭:swapoff -a;
永久注释fstab中所有swap行:sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab。
这一步不可跳过——Kubernetes从v1.8起强制要求Swap完全关闭,否则kubeadm会直接报错退出。
第三步:设置主机名并配置hosts解析
在Master节点运行:hostnamectl set-hostname master;
在各Worker节点分别运行:hostnamectl set-hostname node1、hostnamectl set-hostname node2等;
所有节点同步编辑 /etc/hosts,填入全部节点IP与主机名映射,例如:10.10.75.182 master、10.10.75.284 node1。
注意:不能只依赖DNS,kubeadm初始化阶段严格依赖本地hosts解析,DNS延迟或失败会导致etcd握手超时。
内核级适配配置
方法一:加载必需内核模块
一次性加载:modprobe overlay br_netfilter ip_vs ip_vs_rr ip_vs_wrr ip_vs_sh nf_conntrack;
写入开机自动加载列表:echo -e "overlay\nbr_netfilter\nip_vs\nip_vs_rr\nip_vs_wrr\nip_vs_sh\nnf_conntrack" | sudo tee /etc/modules-load.d/k8s.conf;
立即生效:sudo systemctl restart systemd-modules-load.service。
方法二:配置sysctl网络参数
创建 /etc/sysctl.d/k8s.conf,写入以下内容:net.bridge.bridge-nf-call-ip6tables = 1net.bridge.bridge-nf-call-iptables = 1net.ipv4.ip_forward = 1vm.swappiness = 0fs.file-max = 1048576;
执行 sudo sysctl --system 生效;
【易错点】若执行后提示 cannot stat /proc/sys/net/bridge/bridge-nf-call-iptables,说明br_netfilter未加载成功,需先回退执行方法一。
系统资源与时间同步加固
配置文件描述符与进程数上限:
追加以下内容到 /etc/security/limits.conf:* soft nofile 655360* hard nofile 131072* soft nproc 655350* hard nproc 655350* soft memlock unlimited* hard memlock unlimited。
部署chrony时间同步服务:sudo apt install -y chrony → sudo systemctl enable chronyd → sudo systemctl start chronyd;
验证是否同步:chronyc tracking,输出中 Leap status 应为 Normal,Reference ID 不为 ^L。


















