Linux怎么安装Kubernetes集群教程

千宇吖_7673

千宇吖_7673

2026-06-25

285人浏览

原创

kubeadm init卡在wait-control-plane或节点NotReady,90%因环境未清理、cgroup驱动不一致、--pod-network-cidr与网络插件不匹配;需彻底关闭swap、关闭防火墙、规范主机名、统一cgroup驱动(systemd)、正确配置containerd及匹配CNI网段。

linux怎么安装kubernetes集群教程

直接上结论:用 kubeadm 是当前 Linux 下最可控、最可复现的路径,但不是“装完就能跑”,卡在 kubeadm init 或节点 NotReady 的根本原因,90% 出在环境没清干净、cgroup 驱动不一致、--pod-network-cidr 和网络插件不匹配这三处。

为什么 kubeadm init 一直卡在 wait-control-plane

这不是命令慢,是 kubelet 根本没起来,控制平面静态 Pod(如 kube-apiserver)压根没被调度。常见真实原因:

  • swap 没彻底关:仅 sudo swapoff -a 不够,必须注释掉 /etc/fstab 中所有含 swap 的行,否则重启后自动启用,kubelet 启动时静默失败
  • 防火墙开着:firewalld 或 ufw 默认拦截 6443、10250、2379 等端口,导致 etcd 和 apiserver 无法通信
  • 主机名非法:含下划线(k8s_master)、大写字母(K8S-MASTER)或点号开头,kubeadm 会拒绝生成证书
  • cgroup 驱动错位:containerd 或 Docker 配置了 cgroupfs,但 kubelet 要求 systemd;检查 /var/lib/kubelet/config.yaml 中 cgroupDriver: systemd 是否存在,且 /etc/containerd/config.toml 中 SystemdCgroup = true 已生效

containerd 配置必须改的两处

从 kubeadm v1.24 开始,Docker 不再被直接支持,containerd 是默认推荐运行时。但装完不能直接用,必须手动调两处:

  • 生成配置后必须改驱动:sudo containerd config default | sudo tee /etc/containerd/config.toml,然后编辑该文件,把 SystemdCgroup = false 改成 SystemdCgroup = true
  • 确保 kubelet 启动时能连上 socket:kubeadm init 必须显式指定 --cri-socket=unix:///run/containerd/containerd.sock,否则它会默认找 /var/run/dockershim.sock(已废弃)
  • 别跳过重启:sudo systemctl restart containerd && sudo systemctl enable containerd,否则旧配置仍在内存中

Calico 和 Flannel 的 pod-network-cidr 怎么选

这个参数不是随便填的,它决定了整个集群 Pod 网络地址段,且必须和 CNI 插件 YAML 里定义的完全一致,否则 Node 会卡在 NotReady,日志里反复出现 CNI plugin not found 或 Failed to create pod sandbox。

Kubernetes 301363
Kubernetes 301363

从抖音视频学习: Kubernetes — 【2026最新】这绝对是B站讲的最好的Kubernetes系统精讲教程,全程干货无废话!

下载
  • Flannel 默认认 10.244.0.0/16:部署时用 kubeadm init --pod-network-cidr=10.244.0.0/16,再 kubectl apply -f https://github.com/flannel-io/flannel/releases/download/v0.24.0/kube-flannel.yml
  • Calico 默认认 192.168.0.0/16:如果 init 时用了 --pod-network-cidr=10.244.0.0/16,就必须改 Calico YAML 里的 IP_POOL_CIDR 字段,否则所有 Pod 处于 Pending
  • 别混用:Flannel 不支持 NetworkPolicy,Calico 支持但更重;若只是本地验证,Flannel 更轻量;若后续要对接云厂商 VPC 或需策略控制,优先 Calico

kubectl 连不上或报 certificate expired 怎么办

初始化成功后提示的三行配置命令(mkdir -p $HOME/.kube 那段)必须立刻执行,且不能漏掉 sudo chown。否则 kubectl 默认读 $HOME/.kube/config,而该文件权限不对或路径错误就会报 localhost:8080 was refused 或 x509: certificate has expired。

  • 检查当前配置来源:echo $KUBECONFIG,非空时可能指向了错误路径
  • 验证证书是否过期:openssl x509 -in /etc/kubernetes/pki/apiserver.crt -noout -dates,kubeadm 默认证书只有一年有效期
  • 续期命令不是重装:kubeadm certs renew all && sudo systemctl restart kubelet,然后重新分发 admin.conf
  • 工作节点 join 后仍 NotReady?先 ssh 进去查 sudo journalctl -u kubelet -n 100 --no-pager,看是不是 CNI socket 路径不对或镜像拉取失败

真正容易被忽略的是:所有节点的 kubelet、kubeadm、kubectl 必须小版本号完全一致(比如都是 v1.28.12),差一个 patch 版本都可能导致 control plane 不可用或 join 拒绝——这不是警告,是实际发生的故障。

相关文章

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

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

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

228

19

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

4610

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3853

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

3193

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

7910

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

7542

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

4273

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

3745

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习