Go程序操作Kubernetes Deployment需确保：1. ObjectMeta.Name/Namespace非空；2. Spec.Replicas为非nil指针；3. Spec.Selector与Spec.Template.Labels完全匹配；4. 更新时仅修改可变字段，避免触碰immutable字段。
Go 程序直接操作 Kubernetes Deployment 资源，核心不是“配置”，而是通过 client-go 构造合法的 v1.Deployment 对象并提交给 API Server。多数失败源于对象字段缺失、版本不匹配或 RBAC 权限不足。
用 client-go 创建 Deployment 必须设置的字段
client-go 的 appsv1.Deployment 是结构体，不是 YAML 模板。漏掉 ObjectMeta.Name、ObjectMeta.Namespace 或 Spec.Replicas 会导致创建失败（API Server 返回 422 错误）。
-
ObjectMeta.Name和ObjectMeta.Namespace必须非空；若未指定Namespace，默认为default，但建议显式传入 -
Spec.Replicas是指针类型（*int32），不能为nil；常用写法：replicas := int32(2); &replicas -
Spec.Selector必须与Spec.Template.Labels完全匹配，否则 Deployment 无法关联 Pod —— 这是 90% 的 “部署成功但 Pod 不启动” 问题根源 -
Spec.Template.Spec.Containers[0].Name和Image不能为空；未设Ports不影响创建，但会影响 Service 发现
Deployment 更新时避免滚动更新中断的写法
直接调用 Update() 会覆盖整个对象，容易误删字段（如 Annotations 或自定义 Labels）。推荐用 Patch() 或先 Get() 再修改关键字段。
- 滚动更新应只改
Spec.Template.Spec.Containers[0].Image或Replicas；其他字段（如Env）变更也会触发新 ReplicaSet - 若需保留历史 Revision，确保
Spec.RevisionHistoryLimit> 0（默认 10）；设为 0 会立即清理所有旧 ReplicaSet - 使用
Apply()（需启用 server-side apply）更安全，但要求集群 v1.22+ 且 client-go v0.22+；否则仍推荐Get + Modify + Update流程
常见错误：Invalid value: "": field is immutable
这个错误通常出现在第二次创建同名 Deployment 时 —— 你试图修改 Spec.Selector 或 Spec.Template.Labels。Kubernetes 明确禁止修改这两个字段（immutable），只能删除重建。
立即学习“go语言免费学习笔记（深入）”；
- 真正可变的只有：
Spec.Replicas、Spec.Template.Spec.*（容器镜像、环境变量、资源限制等）、Spec.ProgressDeadlineSeconds等少数字段 - 调试技巧：用
kubectl get deploy/对比你代码构造的对象，重点检查-o yaml spec.selector.matchLabels和spec.template.metadata.labels是否一致、是否在 Update 时被意外重写 - 如果必须改 label selector，先
Delete()再Create()，并在中间加time.Sleep(1 * time.Second)避免 API Server 缓存残留
package mainimport ( "context" appsv1 "k8s.io/api/apps/v1" metav1 "k8s.io/apimachinery/pkg/apis/meta/v1" "k8s.io/client-go/kubernetes" "k8s.io/client-go/tools/clientcmd" )
func createDeployment(clientset *kubernetes.Clientset, namespace, name string) error { replicas := int32(2) deployment := &appsv1.Deployment{ ObjectMeta: metav1.ObjectMeta{ Name: name, Namespace: namespace, }, Spec: appsv1.DeploymentSpec{ Replicas: &replicas, Selector: &metav1.LabelSelector{ MatchLabels: map[string]string{"app": name}, }, Template: apiv1.PodTemplateSpec{ ObjectMeta: metav1.ObjectMeta{ Labels: map[string]string{"app": name}, }, Spec: apiv1.PodSpec{ Containers: []apiv1.Container{{ Name: "nginx", Image: "nginx:1.21", }}, }, }, }, } _, err := clientset.AppsV1().Deployments(namespace).Create(context.TODO(), deployment, metav1.CreateOptions{}) return err }
selector 和 template labels 的一致性、replicas 的非空指针、以及更新时哪些字段真能改——这三点卡住最多人。别信 YAML 转 Struct 工具生成的代码，手动核对字段赋值才是最省时间的做法。
