首页/云/Kubernetes 速查/YAML 多文档与批量应用技巧
kubectl 基础56 条

YAML 多文档与批量应用技巧

单文件用 --- 分隔多个对象、单目录递归应用整个清单集;掌握 apply -f 的目录/URL/标准输入用法,能省去大量重复命令。

Kubernetes 速查云更新于 2026-10-12

多文档示例

多文档示例
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  LOG_LEVEL: info
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  # ... 其余字段

批量应用

批量应用
kubectl apply -f ./manifests/            # 目录下 .yaml/.json 全部应用
kubectl apply -f - < deploy.yaml         # 从标准输入
kubectl apply -f https://example.com/app.yaml
cat base.yaml patch.yaml | kubectl apply -f -
目录模式默认不递归(--recursive 可开);同一目录多个文件的应用顺序按文件名排序,注意依赖顺序时拆批或合并。

易错点

  • 一个文件混放多个对象时,中间一个语法错误会导致整个文件应用失败,排障时先单独校验
  • 文件里含 --- 但空文档(只有注释)会报错,清理干净再提交

数据来源与参考

  • Kubernetes 官方文档 · kubectl apply(目录与多文档)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌