容器与云原生 / 系统课时
准备 Linux 节点
准备 Linux 节点
Linux 节点若保留 swap、缺少桥接 netfilter 或没有开启 IP 转发,kubeadm 与 CNI 很容易在后续步骤失败。下面以使用 systemd 的 Ubuntu 节点为例,一次完成主机名、时间、内核、网络和交换分区准备,并说明防火墙应如何按节点角色放行。
学习目标
- 能把每台 Linux 主机调整为适合 kubeadm 的基础状态。
- 能正确加载
overlay、br_netfilter并开启转发相关 sysctl。 - 能验证时间同步、swap、内核模块和防火墙条件是否满足部署要求。
先确认节点基础条件
每台节点都应有唯一主机名和稳定地址,并能通过 DNS 或受控的主机名解析方式互相找到。准备过程需要 sudo 权限;时间同步服务必须可用,否则证书校验、日志对时和分布式排障都会受到影响。
下面的命令以 Ubuntu 22.04/24.04、systemd 为例。其他发行版的配置文件位置可能不同,但目标状态相同:主机名稳定、时钟同步、必要模块可加载、IPv4 转发开启,并在采用 kubeadm 默认 swap 策略时关闭 swap。
应用主机与内核基线
把 <HOSTNAME> 替换为当前节点规划好的唯一主机名后执行:
set -euo pipefail
NEW_HOSTNAME="<HOSTNAME>"
sudo hostnamectl set-hostname "$NEW_HOSTNAME"
sudo timedatectl set-ntp true
cat <<'EOF' | sudo tee /etc/modules-load.d/k8s.conf >/dev/null
overlay
br_netfilter
EOF
sudo modprobe overlay
sudo modprobe br_netfilter
cat <<'EOF' | sudo tee /etc/sysctl.d/99-kubernetes.conf >/dev/null
net.bridge.bridge-nf-call-iptables = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward = 1
EOF
sudo sysctl --system >/dev/null
sudo swapoff -a
sudo sed -ri '/\sswap\s/s/^#?/#/' /etc/fstab
printf 'hostname=%s\n' "$(hostname)"
printf 'swap_lines=%s\n' "$(swapon --noheadings | wc -l)"
printf 'ip_forward=%s\n' "$(sysctl -n net.ipv4.ip_forward)"
for module in overlay br_netfilter; do
lsmod | awk '{print $1}' | grep -qx "$module" && printf '%s=loaded\n' "$module"
done
printf 'ntp=%s\n' "$(timedatectl show -p NTPSynchronized --value)"预期输出(节点达到目标状态时):
hostname=<HOSTNAME>
swap_lines=0
ip_forward=1
overlay=loaded
br_netfilter=loaded
ntp=yes实际主机名会是你替换后的值。如果最后一行不是 ntp=yes,先修复 NTP 服务再继续;某些镜像使用 chrony 或其他时间服务,此时应以对应工具确认系统时钟已经同步。
按节点角色处理防火墙
生产环境不应为了省事直接关闭主机防火墙。应根据节点角色放行 Kubernetes 必需端口,并额外加入所选 CNI 插件要求的端口或协议。
| 节点角色 | 常见入站端口 | 用途 |
|---|---|---|
| 控制节点 | 6443/tcp |
Kubernetes API Server |
| 控制节点 | 2379-2380/tcp |
etcd 客户端和节点通信 |
| 控制节点 | 10250/tcp |
kubelet API |
| 控制节点 | 10257/tcp、10259/tcp |
controller-manager 与 scheduler 安全端口 |
| 工作节点 | 10250/tcp |
kubelet API |
| 工作节点 | 10256/tcp |
kube-proxy |
| 工作节点 | 30000-32767/tcp,udp |
仅在需要从节点侧访问 NodePort 时放行 |
云环境还要同步检查安全组、网络 ACL 和负载均衡器规则。若后续 CNI 使用 VXLAN、BGP 或其他封装方式,必须按该插件文档再补相应规则,不能把上表当成完整的 CNI 端口清单。
做一次独立验收
配置完成后不要只看命令是否退出成功,还要确认重启后关键设置仍然存在。至少检查 /etc/modules-load.d/k8s.conf、/etc/sysctl.d/99-kubernetes.conf 和 /etc/fstab 已持久化修改,并确认主机名解析、时间同步和防火墙策略与集群拓扑一致。
这一步只把操作系统整理到可部署状态,并没有安装容器运行时、kubelet、kubeadm 或 kubectl。只要主机名稳定、时间已同步、swap 状态符合策略、模块和 sysctl 正确、网络端口已按角色放行,节点就具备继续进行 kubeadm 部署的基础条件。