如何在Linux中安装和使用Kubernetes Linux部署K8s集群的方法

雨辰小哥_1730

雨辰小哥_1730

2026-06-05

664人浏览

原创

linux装kubernetes最稳方式是用kubeadm,但必须严格对齐容器运行时、cgroup驱动、内核模块和网络插件;kubeadm init卡在[wait-control-plane]主因是kubelet无法健康连接控制平面,常见于cgroup驱动不一致、br_netfilter未加载、swap未彻底关闭、hostname或uuid重复、containerd配置中systemdcgroup=false等问题。

如何在linux中安装和使用kubernetes linux部署k8s集群的方法

直接说结论:在 Linux 上装 Kubernetes,别从零手搭,用 kubeadm 是当前最稳、最省事、也最贴近生产逻辑的方式;但必须严格对齐容器运行时、cgroup 驱动、内核模块和网络插件这四块,错一个就卡在 kubeadm init 或节点 NotReady。

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

这是最常见阻塞点,根本原因不是网络慢,而是 kubelet 没法跟控制平面建立健康连接。常见触发条件:

  • kubelet 启动失败(查 systemctl status kubelet,常因 cgroup 驱动不一致)
  • /etc/containerd/config.toml 里 SystemdCgroup = false(k8s v1.24+ 必须为 true)
  • 没加载 br_netfilter 模块,或 sysctl net.bridge.bridge-nf-call-iptables = 0
  • swap 没关彻底(swapoff -a + 注释 /etc/fstab 中 swap 行)
  • hostname、MAC 地址、product_uuid 在多节点中重复(虚拟机克隆后极易发生)

containerd 和 Docker 到底选哪个?

自 k8s v1.24 起,kubeadm 已移除对 Docker Engine 的原生支持,Docker 不再是“开箱即用”的运行时。你有两个选择:

  • 用 containerd(推荐):轻量、稳定、与 systemd 集成好;安装后必须改 /etc/containerd/config.toml,把 SystemdCgroup = false 改成 true,再 systemctl restart containerd
  • 用 cri-dockerd(兼容旧习惯):本质是给 Docker 加一层 CRI 接口桥接;需额外下载二进制、配置 cri-docker.service,并在 kubeadm init 时加 --cri-socket /var/run/cri-dockerd.sock

注意:dockerd 本身仍要配置 {"exec-opts": ["native.cgroupdriver=systemd"]},否则和 kubelet 冲突。

Linux Distros
Linux Distros

Linux发行版游乐场,适用于需要临时Linux沙箱、基于浏览器的Linux虚拟机、一次性终端环境、桌面Linux会话等场景

下载

kubeadm join 失败,Node 一直 NotReady 怎么办?

不是 token 过期就是网络插件没起作用。先确认:

  • 执行 kubectl get pods -n kube-system,看 calico-node 或 coredns 是否 Running;如果全是 Pending 或 ContainerCreating,八成是 CNI 插件没装或 CIDR 冲突
  • 检查 kubeadm init 时是否指定了 --pod-network-cidr(如 Calico 要求 192.168.0.0/16,Flannel 是 10.244.0.0/16),且和后续 CNI 配置一致
  • 节点上 iptables 规则是否被 firewalld/ufw 拦截(CentOS 7 关 firewalld,Ubuntu 关 ufw,或放行 6443、10250、2379 等端口)
  • kubelet 日志里是否有 failed to load KubeConfig 或 connection refused —— 往往是 control plane endpoint 地址写错了

KubeSphere 能不能直接套在已有 k8s 上?

可以,但有硬性约束:KubeSphere 版本和底层 Kubernetes 版本必须匹配。比如 KubeSphere v3.4.x 官方支持 v1.23.x~v1.26.x,但 v1.23 是唯一保证边缘节点功能完整的版本。如果你用 kubeadm 自建了集群,再装 KubeSphere,务必:

  • 确认 kubectl get nodes 全部 Ready,且 coredns Pod 正常运行
  • 提前装好 curl、openssl、socat(KubeKey 依赖)
  • 用 kk 创建集群时显式指定版本:./kk create config --with-kubernetes v1.23.10 --with-kubesphere v3.4.1
  • 别跳过 config.yaml 里的 controlPlaneEndpoint 配置 —— 多 master 场景下,这里必须填负载均衡 VIP 或 DNS 名,不能留空

最容易被忽略的是 etcd 存储路径权限和证书有效期:KubeKey 默认生成的证书只有 1 年,生产环境务必在部署前通过 cert-manager 或手动轮换机制规划续期流程。

相关文章

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

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

下载

相关标签:

linux kubernetes linux

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

188

19

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

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

2023.06.21

3950

4

如何安装LINUX
如何安装LINUX

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

2023.06.29

3393

10

linux find
linux find

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

2023.06.30

2553

5

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

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

2023.07.05

6150

7

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

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

2023.07.06

5802

7

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

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

2023.07.20

3393

8

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

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

2023.07.20

2885

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

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

共0课时 | 0人学习