首页/云/Kubernetes 速查/kubectl --dry-run 试运行与预检
kubectl 基础56 条

kubectl --dry-run 试运行与预检

不真正落库地执行创建/更新:client 模式本地生成对象,server 模式提交 API 服务走准入校验,是改清单前的安全检查。

Kubernetes 速查云更新于 2026-10-12
用途预演变更、生成清单、校验合法性
语法kubectl <命令> --dry-run=client|server

常用示例

常用示例
kubectl apply -f deploy.yaml --dry-run=server
kubectl apply -f deploy.yaml --dry-run=client -o yaml > out.yaml
kubectl create deployment web --image=nginx --dry-run=client -o yaml
kubectl delete pod web-x --dry-run=server
client:不连集群,本地推导,速度快;server:请求真实 API,包含准入控制、默认值填充与 RBAC 校验,但不持久化。

易错点

  • client dry-run 不校验配额、命名冲突与准入 webhook,重要变更必须用 server 模式复检
  • server dry-run 会调用准入 webhook,个别 webhook 未适配 dry-run 时可能报错,此时结合 diff 判断

数据来源与参考

  • Kubernetes 官方文档 · kubectl dry-run
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌