首页/云/云与容器速查/kubectl apply 声明式部署
Kubernetes68 条

kubectl apply 声明式部署

声明式核心命令:按配置文件把资源收敛到期望状态,可重复执行。支持 -f 文件/目录、-k kustomize 目录、--dry-run=server 预检;与 create 的『已存在则报错』形成对比。

云与容器速查云更新于 2026-10-12
语法kubectl apply -f deploy.yaml(也可目录、URL)
kustomize-k overlays/prod/ 渲染后应用(无需 kubectl kustomize 管道)
预检--dry-run=client 本地渲染;--dry-run=server 走 API 校验
幂等可重复执行;依据 last-applied 注解计算变更
对比 createcreate 已存在报错;apply 收敛更新

使用示例

使用示例
kubectl apply -f deploy.yaml
kubectl apply -k overlays/prod/
kubectl apply -f ./manifests/ --dry-run=server
kubectl apply -f web.yaml && kubectl rollout status deploy/web
apply 不删未在文件里的资源(除非 --prune 且配置了 allowlist):删资源要在 GitOps 侧做删除同步。

易错点

  • 对同一资源混用 create/apply/edit:last-applied 注释错乱,apply 结果与文件不符
  • apply 目录里混入旧文件:过期资源被反复写回,与尝试删除的操作打架

数据来源与参考

  • Kubernetes Docs:kubectl apply
  • Kubernetes Docs:Declarative Management

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌