无效的 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 同步
相关资源
相关术语
相关课程
- Kubernetes
学习清单。