首页/云/Kubernetes 速查/K8s YAML 清单结构要点
本包目录(307 条)
kubectl 基础56 条
工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条集群运维与排障54 条

K8s YAML 清单结构要点

一份清单的骨架:apiVersion/kind/metadata/spec 四段;理解缩进、字段层级与「声明期望状态」的语义,是写对 YAML 的基础。

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

最小 Deployment 骨架

最小 Deployment 骨架
apiVersion: apps/v1          # API 组/版本
kind: Deployment             # 资源类型
metadata:
  name: web
  namespace: prod
  labels:
    app: web
spec:
  replicas: 3
  selector:                  # 必须匹配 template 标签
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: web
          image: nginx:1.25.3
          ports:
            - containerPort: 80

易错点速记

易错点速记
缩进用空格不用 Tab;同一层级缩进必须一致
字符串含特殊字符时加引号(如 '8080'、'yes'、'on')
selector 与 template.labels 不匹配 → 创建被拒
改不可变字段(selector 等)→ 需要删除重建
apiVersion 要写「组/版本」(apps/v1),核心资源如 Pod/Service 是 v1;不确定用 kubectl explain 或 api-resources 查。

易错点

  • YAML 把 yes/no/on 解析为布尔值,版本号、端口这类需要字符串的字段要加引号
  • status 段是只读的运行时状态,写清单时永远不要写 status

数据来源与参考

  • Kubernetes 官方文档 · Object Management / API Conventions
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌