讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Linux怎么安装Kubernetes集群教程

千宇吖_7673

千宇吖_7673

发布时间:2026-06-25 13:00:43

|

285人浏览过

|

来源于php中文网

原创

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 是默认推荐运行时。但装完不能直接用,必须手动调两处:

Kubernetes 301363
Kubernetes 301363

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

下载
  • 生成配置后必须改驱动: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。

  • 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 拒绝——这不是警告,是实际发生的故障。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

116

2025.12.22

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

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

228

2026.06.29

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

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

4610

2023.06.21

如何安装LINUX
如何安装LINUX

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

3853

2023.06.29

linux find
linux find

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

3193

2023.06.30

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

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

7910

2023.07.05

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

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

7542

2023.07.06

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

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

4273

2023.07.20

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn