讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

立刻MV
立刻MV

低成本歌曲 MV、视频生成

离线环境Kubernetes集群部署教程

雨磊姑娘_3569

雨磊姑娘_3569

发布时间:2026-11-22 08:05:27

|

362人浏览过

|

来源于php中文网

原创

离线部署Kubernetes失败主因是三类资源不匹配:二进制架构错(如ARM服务器误用x86 kubeadm)、镜像tag漏或版本不一致(如etcd 3.5.15-0写成3.5.15)、YAML中仍引用registry.k8s.io等外网地址;须严格统一kubeadm/kubelet/kubectl版本与架构,逐个load校验镜像,本地化所有YAML镜像路径,并显式指定--image-repository等参数。

离线环境kubernetes集群部署教程

离线部署 Kubernetes 不是“把镜像和二进制拷过去就能跑”,失败几乎都卡在三类资源不匹配:二进制架构错、镜像 tag 漏或版本不一致、YAML 里写的镜像地址还是 registry.k8s.io。

怎么确认 kubeadm/kubelet/kubectl 版本和架构必须严格一致

ARM 服务器上用 x86 的 kubeadm 直接报 Exec format error;同理,kubelet 和 kubectl 如果混用 v1.32 和 v1.35,kubeadm init 会提示证书签名失败或无法生成 manifest。官方发布页(如 kubernetes-server-linux-arm64.tar.gz)里打包的是整套对应组件,别自己拼凑。

  • 查当前系统架构:uname -m → 输出 aarch64 就必须用 arm64 包,x86_64 才能用 amd64
  • 验证三个二进制版本统一:kubeadm version -o short、kubelet --version、kubectl version --client --short 三者输出必须完全一样,例如 v1.35.6
  • chmod +x 缺一不可——/usr/bin/kubeadm 权限为 644 时,kubeadm init 报 permission denied 不提示具体文件,只卡在 preflight 检查

docker load 镜像前必须先核对镜像列表是否完整

控制平面启动失败,90% 是因为 etcd 或 pause 镜像没 load 进去。kubeadm 不会报“缺哪个镜像”,而是卡在 waiting for etcd to become available 或反复重启 kube-apiserver 容器。

Kubernetes 301363
Kubernetes 301363

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

下载
  • 先在联网机器上执行:kubeadm config images list --kubernetes-version=v1.35.6,记下全部 12–15 个镜像名(含 registry.k8s.io/etcd:3.5.15-0、registry.k8s.io/pause:3.9 等)
  • 每个镜像必须用 docker pull && docker save -o xxx.tar 导出,不能用 skopeo copy 或 ctr images export —— 后两者生成的不是标准 tar,docker load 会报 invalid format
  • 离线节点上逐个 load:docker load -i images/kube-apiserver_v1.35.6.tar,然后 docker images | grep kube 确认 tag 对得上,别出现 <none></none>

calico.yaml 或 flannel.yaml 里的镜像地址必须本地化

YAML 文件里还写着 quay.io/calico/cni:v3.27.2,但你只 load 了 localhost:5000/calico/cni:v3.27.2,kubectl apply 后 Pod 一直 ImagePullBackOff,日志里却只显示 “failed to resolve reference”,根本看不出是地址不对。

  • 编辑 calico.yaml 前先确认你 load 进来的镜像名:docker images --format "{{.Repository}}:{{.Tag}}" | grep calico
  • 全局替换 YAML 中所有 quay.io/calico/ 为你的内网地址,例如 harbor.internal/calico/ 或直接 localhost:5000/calico/
  • 如果用 Docker Registry 本地仓库,确保 imagePullPolicy: IfNotPresent,否则即使本地有也会去远端拉
  • 别漏掉 coredns 的 YAML——它默认从 registry.k8s.io/coredns/coredns 拉,同样要改地址并提前 load

kubeadm init 命令顺序和参数不能省略

很多人以为 kubeadm init 能自动 fallback 到本地镜像,其实它默认仍会尝试连外网校验,没网络就卡住或超时失败。必须显式指定所有依赖项路径和行为。

  • 先运行:kubeadm config images pull --kubernetes-version=v1.35.6 --image-repository=localhost:5000,验证所有 control plane 镜像都能被识别(不报错即成功)
  • 再执行 init:kubeadm init --pod-network-cidr=10.244.0.0/16 --image-repository=localhost:5000 --cri-socket=unix:///var/run/containerd/containerd.sock(注意 --cri-socket 要和实际运行时匹配)
  • init 成功后,立刻执行:mkdir -p $HOME/.kube && sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config && sudo chown $(id -u):$(id -g) $HOME/.kube/config,否则 kubectl get nodes 报 connection refused

最容易被忽略的是:etcd 镜像版本必须和 kubeadm 声明的完全一致,差一个 patch 号(比如 3.5.15-0 写成 3.5.15)就会导致 init 卡死;还有 calico/node 镜像和 calico/cni 镜像必须同版本,否则 CNI 插件注册失败,Pod 无法分配 IP。

热门AI工具

更多
花生AI
花生AI Hot

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

WorkBuddy

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

DeepSeek

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

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款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

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

0

2026.11.20

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

0

2026.11.20

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

0

2026.11.20

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

0

2026.11.20

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

0

2026.11.20

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

20

2026.11.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kubernetes官方教程手册
Kubernetes官方教程手册

共0课时 | 0人学习

Kubernetes官方中文文档
Kubernetes官方中文文档

共0课时 | 0人学习

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

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