首页/云/Kubernetes 速查/kubectl wait 等待资源条件
kubectl 基础56 条

kubectl wait 等待资源条件

阻塞等待资源达到指定条件(可用、就绪、删除完成),把「等就绪」从 sleep 猜测变成确定性等待,适合脚本与 CI。

Kubernetes 速查云更新于 2026-10-12
用途等待资源满足条件或消失
语法kubectl wait --for=<条件> <资源>/<名称> [--timeout=...]

常用示例

常用示例
kubectl wait --for=condition=Available deploy/web --timeout=180s
kubectl wait --for=condition=Ready pod/web-x --timeout=120s
kubectl wait --for=jsonpath='{.status.phase}'=Running pod/web-x
kubectl wait --for=delete pod/web-x --timeout=60s
支持 --for=condition=...、--for=jsonpath=...=值、--for=delete;默认超时 30s,生产脚本显式加大。

易错点

  • 不同资源的可用条件不同(Deployment Available、Pod Ready、Job Complete),条件写错会一直等到超时
  • wait 超时返回非零退出码,脚本里要处理,避免后续步骤带着未就绪状态继续跑

数据来源与参考

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