Skip to content

无效的 Kubernetes 清单:未知字段

快速摘要

你的 Kubernetes 清单有未知字段 —— API 服务器拒绝资源定义。

为什么发生

  • 字段名拼写错误或在该资源类型的 Kubernetes API 中不存在

  • 字段来自与 apiVersion 中指定的不同 API 版本

  • 使用了自定义资源定义字段但未安装 CRD

最小示例

✗ 错误代码
apiVersion: apps/v1
kind: Deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  templete: # typo: templete instead of template
    metadata:
      labels:
        app: web
✓ 修复代码
apiVersion: apps/v1
kind: Deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template: # correct field name
    metadata:
      labels:
        app: web

将字段名从 'templete' 更正为 'template' 使清单对 Kubernetes API 有效。

如何诊断

  • 使用 kubectl apply --dry-run=client 在应用前验证清单

  • 查看 Kubernetes API 参考以获取资源类型和 apiVersion 的有效字段

  • 验证清单中引用的任何 CRD 已安装在集群中

如何修复

  • 更正字段名以匹配资源类型的 Kubernetes API

  • 将 apiVersion 更改为支持所使用字段的版本

  • 在应用使用 CRD 字段的清单前安装所需的 CRD

如何预防

  • 在 CI 中使用 kubectl apply --dry-run=client 或清单验证器尽早捕获错误

  • 保持 Kubernetes 清单与集群的 API 版本和已安装 CRD 同步

相关资源

相关术语

相关课程

← 返回语言