Linux部署Kubernetes节点_kubeadm初始化与节点加入全流程剖析【教程】

kubeadm部署Kubernetes集群核心为两步：控制平面节点初始化与工作节点加入；需满足操作系统、关闭swap、防火墙配置、bridge-nf-call-iptables、唯一可解析hostname及时间同步等前置条件。

用 kubeadm 部署 Kubernetes 集群，核心就两步：控制平面节点（master）初始化 + 其他节点加入。流程不复杂，但细节多、易出错。下面按真实部署顺序，把关键点和常见坑说清楚。

前置条件必须到位

所有节点（包括 master）都要满足这些基础要求，缺一不可：

• 操作系统：CentOS 7.6+ / Ubuntu 20.04+（推荐 LTS 版本），内核 ≥ 3.10
• 关闭 swap：swapoff -a 并注释 /etc/fstab 中 swap 行
• 关闭防火墙或放行必要端口（如 6443、10250、2379–2380 等），生产环境建议用 iptables 或 firewalld 精确控制
• 配置 bridge-nf-call-iptables=1（加载 br_netfilter 模块并写入 sysctl）
• 每个节点 hostname 唯一且可被解析（/etc/hosts 或 DNS），不能含下划线
• 时间同步：所有节点运行 chronyd 或 ntpd，偏差超过 1s 可能导致证书校验失败

kubeadm init 初始化控制平面节点

在计划作为 master 的节点上执行。重点不是命令本身，而是参数选对、输出看懂：

• 推荐显式指定 kubernetes 版本（避免自动拉最新不稳定版）：
  kubeadm init --kubernetes-version=v1.28.6 --pod-network-cidr=10.244.0.0/16
• --pod-network-cidr 必须和后续 CNI 插件（如 Flannel）的网段一致，Flannel 默认用 10.244.0.0/16，Calico 常用 192.168.0.0/16
• 若节点有多个网卡，加 --apiserver-advertise-address=xxx.xxx.xxx.xxx 指定监听的内网 IP
• 成功后会输出 kubeadm join 命令（含 token 和 ca cert hash），务必保存——24 小时后 token 过期，需用 kubeadm token create --print-join-command 重新生成
• 初始化完成后，按提示配置当前用户使用 kubeconfig：
  mkdir -p $HOME/.kube && sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config && sudo chown $(id -u):$(id -g) $HOME/.kube/config

安装 Pod 网络插件（CNI）

master 初始化完只是“半成品”，没有 CNI，Pod 无法跨节点通信，kubectl get nodes 会卡在 NotReady：

标签： linux centos js git json node github 操作系统 防火墙 app 端口 ubuntu