如何用Kubernetes部署本地镜像

夏枫大大_5360

夏枫大大_5360

2026-09-07

1011人浏览

原创

生产级kubernetes集群不会自动同步本地docker镜像,必须推送至可访问的镜像仓库或显式加载到各节点运行时;imagepullbackoff因k8s默认拉取远程registry而非本地构建镜像所致。

如何用kubernetes部署本地镜像

直接用 kindminikube 启动的集群默认支持本地镜像加载,但生产级 Kubernetes 集群(如 kubeadm、Kubespray、云厂商托管集群)**不会自动同步本地 Docker daemon 中的镜像**——必须显式推送到可访问的镜像仓库,或通过其他机制让节点能拉到镜像。

为什么 docker buildkubectl apply 会报 ImagePullBackOff

这是最常见误解:以为在本地 docker build -t myapp:latest . 之后,Kubernetes 就能直接用这个 tag。实际上:

  • Kubernetes 的每个 Node 自己运行独立的容器运行时(通常是 containerd 或 docker),它不共享你的开发机上的镜像层
  • image: myapp:latest 是一个“拉取地址”,Kubernetes 会尝试从默认 registry(docker.io)找 library/myapp:latest,而不是读你本机的镜像缓存
  • 除非你显式配置了 imagePullPolicy: Never 且该镜像已存在于该 Node 的运行时中,否则一定会触发拉取

imagePullPolicy: Never 能不能绕过仓库?

可以,但仅限单节点、调试场景,且需满足两个硬条件:

  • 镜像必须已提前 docker loadctr -n=k8s.io images import 到目标 Node 的运行时中(不是你的开发机)
  • Deployment/Pod 的 image 字段必须与本地镜像的 repo:tag 完全一致(包括 registry 前缀,如 localhost:5000/myapp:v1
  • 若用 kind,可用 kind load docker-image myapp:latest 把镜像注入集群节点;minikube 对应命令是 minikube cache add myapp:latest

注意:imagePullPolicy: Never 在多节点集群中不可靠——你无法保证所有 Node 都有同一镜像,且滚动升级时新调度的 Pod 可能落在没镜像的 Node 上。

Kubernetes Skills
Kubernetes Skills

针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。

下载

真正可靠的本地镜像部署路径

所谓“本地镜像”,本质是“非公有仓库托管的镜像”。可靠做法永远是:把镜像推到一个 Kubernetes 集群能访问的私有 registry,哪怕它只跑在你集群的一个 Pod 里。

  • 最轻量方案:在集群内起一个 registry:2 Pod(用 ClusterIP Service 暴露),然后 docker push localhost:5000/myapp:v1(需先 docker login -u foo -p bar localhost:5000
  • 企业级方案:部署 Harbor(推荐 Helm 安装),设置 expose.type=clusterIP,用 image: harbor.your-domain.com/project/myapp:v1
  • 无论哪种,Deployment 中必须加 imagePullSecrets(即使 registry 不需要认证,也要创建空 secret 并引用,否则 containerd 1.7+ 会拒绝拉取无认证头的请求)
  • 镜像 tag 强烈建议用 Git SHA 或语义化版本(如 v1.2.3),禁用 :latest ——后者在 imagePullPolicy: IfNotPresent 下可能跳过更新

调试时快速验证镜像是否真被节点拉到

别只看 kubectl get pods,要确认运行时层面:

  • 进对应 Node 执行:crictl images | grep myapp(containerd)或 docker images | grep myapp(docker)
  • 查 Pod 事件:kubectl describe pod <pod-name></pod-name>,重点看 Events 区域最后一行是否为 Pulled 而非 Failed
  • 如果看到 rpc error: code = Unknown desc = failed to pull and unpack image...,大概率是镜像 digest 不匹配或 registry TLS 证书未信任

真正的“本地”只存在于开发机;Kubernetes 看到的永远是远程地址。把 registry 当作必经网关,比折腾 Never 策略省三天时间。

相关文章

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

96

5

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

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

2026.06.29

148

19

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

20

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

0

19

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

2026.09.22

0

19

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习