Kubernetes部署Deployment时出现未知字段错误的解决求助

1. 错误原因定位 #

报错信息明确指出spec.template.spec.containers[0].envFrom[0].name是未知字段，这是由于YAML配置中envFrom下的secretRef结构缩进错误导致的。原配置里name与secretRef处于同级，不符合Kubernetes的字段定义规则，正确的结构应该是name作为secretRef的子属性。

2. 修正Deployment YAML文件 #

调整envFrom部分的缩进，将name嵌套到secretRef内部，修正后的完整配置如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: django-k8-web-deployment
  labels:
    app: django-k8-web-deployment

spec:
  replicas: 3

  selector:
    matchLabels:
      app: django-k8-web-deployment

  template:
    metadata:
      labels:
        app: django-k8-web-deployment
    spec:
      containers:
        - name: django-k8s-web
          image: registry.digitalocean.com/chrisocean/django-k8s-web:latest
          envFrom:
            - secretRef:
                name: django-k8s-web-prod-env
          env:
            - name: PORT
              value: "8001"
          ports:
            - containerPort: 8001
      imagePullSecrets:
        - name: oceandev

3. 重新部署应用 #

执行以下命令重新应用修正后的配置：

kubectl apply -f k8s/apps/django-k8s-web.yaml

4. 验证Pod状态 #

部署完成后，检查Pod状态：

kubectl get pods

正常情况下Pod会从Pending状态转为Running。如果状态仍异常，可通过kubectl describe pod <pod名称>查看具体事件，排查镜像拉取失败、资源不足等其他潜在问题。

内容的提问来源于stack exchange，提问作者saint chris