首页/云/Kubernetes 速查/kubectl replace 整体替换对象
kubectl 基础56 条

kubectl replace 整体替换对象

用新对象整体替换现有对象(先删后建语义的更新),处理 apply 难以覆盖的场景;--force 可删除重建用于不可变字段。

Kubernetes 速查云更新于 2026-10-12
用途用清单整体替换现网对象
语法kubectl replace -f <文件>;kubectl replace --force -f <文件>

常用示例

常用示例
kubectl replace -f svc.yaml
kubectl replace --force -f svc.yaml
kubectl get svc web -o yaml > web.yaml && vi web.yaml && kubectl replace -f web.yaml
replace 要求对象已存在(不存在报错,用 apply/create 创建);--force 是删除后立即重建,Service 会短暂中断。

易错点

  • --force 重建期间对象(尤其是 LoadBalancer Service)可能短时不可用,评估窗口后再用
  • replace 覆盖的字段来自清单,可能与现网既有配置差异过大,先 diff 再执行

数据来源与参考

  • Kubernetes 官方文档 · kubectl replace
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌