手改的配置总被流水线抹掉:Server-Side Apply 的字段所有权
kubectl edit 加的配置第二天被 apply 抹掉,不是流水线全量覆盖,而是字段所有权的问题。本文讲清 last-applied 与 managedFields 两套机制、冲突怎么读,以及迁移与接管字段的正确写法。
手动 kubectl edit 加的 env,第二天被流水线 apply 抹回去了。很多人以为是流水线「全量覆盖」,其实是字段所有权的问题:对象由谁创建、用哪种 apply,决定了谁说了算。
last-applied 与 managedFields 是两套机制
客户端 apply(kubectl apply 的默认行为)靠 kubectl.kubernetes.io/last-applied-configuration 这个注解做三方合并:本地文件、注解里记录的上次配置、集群现状。
这个机制有个前提——注解存在。如果对象是 kubectl create 建的、或者是 Server-Side Apply 建的,注解是空的,客户端 apply 就没有「上次」这个概念,会把文件里没写、但集群里存在的字段当成多余项删掉。别人手改的副本数、env、注解,就这么消失了。
Server-Side Apply(--server-side)换了一套账本:metadata.managedFields 记录每个字段由哪个 manager、哪种操作写入。字段有明确归属,改别人的字段会被明确拒绝,而不是悄悄抹掉。
冲突长什么样
Apply failed with 1 conflict: conflict with "kubectl-edit" using apps/v1: .spec.replicas
读法:spec.replicas 当前归 kubectl-edit 这个 manager 所有,你这次 apply 的 manager 不是它,所以要改必须显式声明「我知道我在抢」。
先看清楚谁在管什么,比直接加强制参数有用得多:
# 看字段归属,重点看 manager / operation / fieldsV1
kubectl get deploy api -n prod --show-managed-fields -o yaml \
| sed -n '/managedFields:/,/^ [a-z]/p'
# 只想知道有没有冲突,先 diff 一次
kubectl diff -f deploy.yaml
operation 是 Apply 的条目才受 SSA 约束;Update 说明这个 manager 走的是读改写(kubectl edit、scale、patch 都是),SSA 的冲突检查管不住它,这也是后面要说的边界。
迁移与抢字段的两种写法
一次性把对象接管过来,用固定 manager 名,方便以后追溯是谁写的:
# 迁移:接管所有权,同时抢下有冲突的字段(只在迁移时用一次)
kubectl apply --server-side --force-conflicts \
--field-manager=ci-pipeline -f deploy.yaml
# 日常发布:不带 force,有冲突就失败,让冲突暴露出来
kubectl apply --server-side --field-manager=ci-pipeline -f deploy.yaml
--force-conflicts 会把对方的字段抢过来。如果对方下次也带 force 再抢回去,两个 manager 就会形成拉锯,配置在两次发布之间来回跳,比直接报错更难查。
团队里怎么落
一条原则就够:一个对象只允许一个写入者。CI 用固定 manager,人不在生产上 kubectl edit;临时变更走 Git 或者变更单,改完由流水线落地。
如果同时用 Helm、ArgoCD 和手写 manifest,先把 manager 名统一,否则三套工具互相认定对方是"篡改者"。ArgoCD 这类工具自身也会写 manager 字段,接入 SSA 前先在预发环境跑一轮,观察 diff 是否稳定。
适用边界与常见坑
--force-conflicts不是修复手段,是迁移工具。日常流水线里带着它,等于关掉了 SSA 最有价值的保护。- CRD 的 SSA 合并行为依赖 CRD 的 schema。没写
x-kubernetes-list-type的 list 字段,合并结果不可预期,可能出现重复项。 kubectl scale、kubectl edit、kubectl patch走的是读改写,SSA 的冲突检测覆盖不到。防止它们改生产,只能靠权限。- 不要把 last-applied 注解当垃圾清掉。删了之后客户端 apply 失去三方合并基准,下一次 apply 的删除行为会变得难以预测。
正在加载评论…