Ubuntu 22.04 搭建 K8s 集群教程 Kubernetes部署全过程【详解】

浅丽姑娘_8985

浅丽姑娘_8985

2026-05-05

876人浏览

原创

ubuntu 22.04 上用 kubeadm 搭 k8s 集群必须先禁用 swap、关闭 ufw、配好 /etc/hosts 和内核参数,否则 kubeadm init 必失败或节点 notready;因 swap 未关会触发 [error swap],ufw 会拦截 calico vxlan 流量,hosts 解析错误导致 kubelet 自连失败,内核参数缺失则桥接流量不通、cgroup driver 不匹配(containerd 未设 systemdcgroup=true)将使 kubelet 拒绝启动。

ubuntu 22.04 搭建 k8s 集群教程 kubernetes部署全过程【详解】

直接说结论:Ubuntu 22.04 上用 kubeadm 搭 K8s 集群,**必须先关 swap、关 ufw、配好 /etc/hosts 和内核参数,否则 kubeadm init 必失败或节点卡在 NotReady**。这不是可选项,是硬性前提。

为什么 kubeadm init 会报 “cgroup driver mismatch” 或直接卡住

Ubuntu 22.04 默认用 systemd cgroup driver,但 containerd 若没显式配置,可能 fallback 到 cgroupfs;kubelet 启动时发现不一致就拒绝工作。

  • 检查当前 kubelet 使用的 driver:sudo systemctl cat kubelet | grep "cgroup-driver",若没输出,说明没显式指定
  • 确认 containerd 实际使用的 driver:sudo ctr version 不显示 driver,得看 config:sudo cat /etc/containerd/config.toml | grep systemd
  • 正确做法:编辑 /etc/containerd/config.toml,确保有 [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options] 下的 SystemdCgroup = true
  • 改完必须重启:sudo systemctl restart containerd && sudo systemctl restart kubelet

kubeadm init 失败常见错误信息与对应动作

看到这些提示别急着重装,多数是环境没清理干净或配置漏项:

Kubernetes Security Posture Scorecard
Kubernetes Security Posture Scorecard

评估 Kubernetes 集群安全态势,覆盖 RBAC、工作负载安全、网络策略、基础设施即代码(IaC)、运行时监控和密钥管理等 30 项控制项……

下载
  • [ERROR Swap]: running with swap on is not supported → 执行 sudo swapoff -a 后,**必须注释掉 /etc/fstab 中 swap 行**,否则 reboot 后复活
  • [ERROR FileContent--proc-sys-net-bridge-bridge-nf-call-iptables]: /proc/sys/net/bridge/bridge-nf-call-iptables does not exist → 缺少内核模块,运行 sudo modprobe br_netfilter 并写入 /etc/modules-load.d/k8s.conf
  • failed to load KubeConfig: stat /etc/kubernetes/admin.conf: no such file or directory → kubeadm init 根本没跑成功,先查 sudo kubeadm init --dry-run -v 5 看前置检查哪步挂了
  • init 卡在 [wait-control-plane] Waiting for the kubelet to boot up the control plane → 很可能是 containerd 没拉到 pause 镜像,手动试:sudo crictl pull registry.k8s.io/pause:3.9

Calico 安装后 Node 仍是 NotReady 的关键排查点

不是 Calico yaml 下载下来 kubectl apply 就完事。Ubuntu 22.04 默认启用 ufw,它会拦截 Calico 节点间 VXLAN 流量(UDP 8472),导致 BGP 无法建连。

  • 确认 ufw 状态:sudo ufw status verbose,即使显示 inactive,也建议执行 sudo ufw disable 彻底关闭
  • 检查 Calico pod 是否都 Running:kubectl get pods -n kube-system -l k8s-app=calico-node,若有 CrashLoopBackOff,进日志:kubectl logs -n kube-system -l k8s-app=calico-node
  • 常见日志错误:Failed to get node "<hostname>" (k8s): connection refused</hostname> → kubelet 未就绪,回退检查 sudo systemctl status kubelet
  • Calico 默认使用 bird 做 BGP,它依赖主机路由表。Ubuntu 22.04 的 netplan 可能生成多余路由规则,用 ip route show table all 查是否有冲突

最易被忽略的一点:所有节点的 hostname 必须和 kubeadm join 时自动注册的 Node 名字完全一致——也就是 kubectl get nodes 显示的名字。如果用了 hostnamectl set-hostname 但没同步更新 /etc/hosts 里的解析,kubelet 启动时会连不上自己,Node 状态永远卡在 NotReady。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

ubuntu kubernetes

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务

Golang云原生微服务Kubernetes (K8s) 是指 使用 Go 语言(Golang)编写的云原生微服务,并利用 Kubernetes 平台进行容器化部署、自动化管理、弹性伸缩和高效编排的一整套现代应用架构方案。

2025.12.22

116

5

Go云原生应用与Kubernetes服务部署实战
Go云原生应用与Kubernetes服务部署实战

本专题围绕 Go 语言在云原生环境中的应用展开,讲解容器化部署、Kubernetes 编排、服务发现、健康检查与弹性扩缩容机制。通过真实云端案例,帮助开发者构建可扩展的云原生微服务架构。

2026.06.29

168

19

常见的linux系统有哪些
常见的linux系统有哪些

linux系统有Ubuntu、Fedora、CentOS、Debian、openSUSE、Arch Linux、Gentoo、Slackware、Linux Mint、Kali Linux。更多关于linux系统的文章详情请阅读本专题下面的文章。php中文网欢迎大家前来学习。

2023.10.27

5881

23

ubunt上安装和配置vnc
ubunt上安装和配置vnc

安装方法:安装VNC服务器、启动VNC服务器、设置VNC密码等等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

2023.12.28

1941

8

ubuntu启动黑屏解决方法
ubuntu启动黑屏解决方法

ubuntu启动黑屏解决方法:检查是否是电源问题、检查内存是否接触不良、检查显卡问题等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

2023.12.28

1670

6

为什么ubuntu有网络连接但不能上网
为什么ubuntu有网络连接但不能上网

ubuntu有网络连接但不能上网的原因:1、dns配置问题;2、代理服务器设置问题;3、网络防火墙设置问题;4、路由器或调制解调器设置问题;5、网络驱动程序问题;6、网络配置文件问题;7、其他问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.05

1021

6

ubuntu安装golang
ubuntu安装golang

本专题整合了ubuntu安装golang所有方法汇总,阅读下面的文章了解更多详细操作。

2025.12.13

339

13

Linux如何安装Ubuntu并完成基础系统优化教程
Linux如何安装Ubuntu并完成基础系统优化教程

访问Ubuntu官网或国内镜像站下载ISO镜像,利用Rufus或Etcher工具制作USB启动盘。重启电脑进入BIOS设置U盘引导,按提示完成分区与账户设置以安装系统。安装完毕后,首要任务是将软件源更换为国内镜像以加速下载,接着在终端执行更新命令升级系统组件,并安装显卡驱动及常用开发工具,至此即可完成基础环境搭建与优化。

2026.03.31

84

6

Ubuntu系统安装与基础配置
Ubuntu系统安装与基础配置

本指南详解Ubuntu系统安装全流程:从制作启动盘、分区规划到驱动配置,手把手带你完成系统部署。涵盖软件源优化、常用工具安装及桌面个性化设置,助你快速搭建稳定高效的Linux开发环境,零基础也能轻松上手。

2026.04.15

126

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程