Kubernetes中patch更新Deployment镜像必须用StrategicMergePatchType等patch方式，不能直接Update，因API禁止对已存在对象spec全量覆盖；patch不校验镜像存在性，拉取失败表现为ImagePullBackOff。
用 client-go patch 更新 Deployment 镜像
直接改 deployment.spec.template.spec.containers[0].image 并调用 Update 会失败——Kubernetes API 不允许对已存在对象的 spec 做全量覆盖式更新（除非用 replace，但那会丢掉所有服务器端默认值和状态字段）。必须用 patch。
推荐用 StrategicMergePatchType，它语义清晰、兼容性好，且 client-go 默认支持：
patchData := []byte(`{
"spec": {
"template": {
"spec": {
"containers": [
{
"name": "my-app",
"image": "nginx:1.25"
}
]
}
}
}
}`)
_, err := appsV1.Patch(context.TODO(), "my-deployment", types.StrategicMergePatchType, patchData, metav1.PatchOptions{})
if err != nil {
// 处理错误，比如 ImagePullBackOff 或 NotFound
}
-
name字段必须与原容器名完全一致，否则 patch 会新增容器而非替换 - 如果 Deployment 有多个容器，需确保 patch 中只列出要更新的容器，或显式写出全部容器（避免遗漏导致被清空）
- patch 不校验镜像是否存在，拉取失败会在 Pod 状态中体现为
ImagePullBackOff
为什么不能只改 image 字段就触发滚动更新
Deployment 的滚动更新由其 spec.template 整体哈希决定。只要该模板里任意字段变化（哪怕只是加个空格或改 terminationGracePeriodSeconds），就会生成新 ReplicaSet 并触发滚动更新。
但仅改 image 是最安全、最直观的触发方式；其他字段改动可能带来副作用：
立即学习“go语言免费学习笔记（深入）”；
- 改
terminationGracePeriodSeconds可能影响优雅终止逻辑，尤其在有长连接场景下 - 改
env或volumeMounts若配置错误，会导致新 Pod 启动失败，卡住滚动过程 - client-go 中若 patch 内容语法错误（如 JSON 缺少逗号），API 会返回
BadRequest而非静默忽略
如何避免镜像拉取失败导致滚动卡死
滚动更新卡在 ContainerCreating 或反复重启，90% 是镜像拉取问题。关键不是“怎么推镜像”，而是“集群能否拉到”：
- 确认镜像仓库地址可访问：
docker pull your-registry.com/myapp:1.25在任一 worker 节点上能成功 - 检查
imagePullPolicy：如果是"IfNotPresent"，而本地已有旧镜像，新 tag 不会重拉；生产环境建议设为"Always"（尤其用:latest时） - 私有仓库必须配置
imagePullSecrets，且 secret 必须在 Deployment 所在 namespace 中存在 - 用
kubectl describe pod <new-pod-name>查看 Events，第一行通常就是失败原因（如Failed to pull image "xxx": rpc error: code = Unknown desc = failed to pull...）
更新后如何验证是否生效
别只看 kubectl get deploy 显示 UP-TO-DATE，那只是 ReplicaSet 数量同步了。真正要看的是 Pod 模板是否落地：
- 查当前活跃的 ReplicaSet：
kubectl get rs -l app=my-app，挑一个CURRENT > 0的 RS - 查它的 Pod 模板镜像：
kubectl get rs <rs-name> -o jsonpath='{.spec.template.spec.containers[0].image}' - 对比实际运行中的 Pod：
kubectl get pods -l app=my-app -o jsonpath='{.items[0].spec.containers[0].image}' - 三者不一致说明 patch 成功但新 Pod 还没调度完，或镜像拉取失败卡住了
滚动更新的实质是 ReplicaSet 切换，不是“改一个字段就立刻所有 Pod 变”，这个延迟和中间态必须纳入监控和判断逻辑。
