部署应用至Kubernetes集群时ConfigMaps未找到问题排查

从你提供的Deployment配置和错误日志来看，问题的核心是Kubernetes集群无法找到你部署文件中指定的三个ConfigMap资源。下面我会逐一分析可能的原因，并给出对应的解决步骤：

先确认你的配置语法没问题 #

首先检查了你的deployment.yml，其中volumes和volumeMounts的名称对应关系是正确的，配置语法没有明显错误，所以问题大概率出在ConfigMap资源本身的状态上。

可能的原因及解决方法 #

1. ConfigMap未创建或名称拼写错误 #

你的Deployment指定了三个ConfigMap：sample-volume-dev-my-app、sample-volume1-dev-my-app、sample-volume2-dev-my-app，首先要确认这些资源是否存在于dev-space命名空间下（你的Deployment部署在这个命名空间）。

• 执行以下命令检查目标命名空间的ConfigMap列表：

  kubectl get configmaps -n dev-space
  

  • 如果输出中没有这三个ConfigMap，说明你需要先创建对应的ConfigMap资源。
  • 如果存在但名称不匹配，要修正Deployment中volumes[].configMap.name的字段，确保和实际ConfigMap名称完全一致（Kubernetes资源名称区分大小写）。

2. ConfigMap与Deployment不在同一个命名空间 #

Kubernetes的资源是命名空间隔离的，如果你的ConfigMap创建在其他命名空间（比如默认的default），而Deployment在dev-space，那么kubelet会找不到对应的ConfigMap。

• 可以执行全局查找命令确认ConfigMap的位置：

  kubectl get configmaps --all-namespaces | grep "sample-volume"
  

  • 如果发现ConfigMap在其他命名空间，推荐将ConfigMap迁移到dev-space；如果必须跨命名空间使用，可以在Deployment的volume配置中添加namespace字段指定ConfigMap所在的命名空间：

    volumes:
    - name: "sample-volume"
      configMap:
        name: "sample-volume-dev-my-app"
        namespace: your-configmap-namespace # 替换为实际命名空间
    

3. 资源创建顺序导致的时序问题 #

如果是同时创建Deployment和ConfigMap，可能会出现Deployment先被调度，但ConfigMap还未完成创建的情况，导致kubelet挂载失败。

• 解决方法是调整创建顺序，先创建ConfigMap再部署Deployment：

  # 先创建ConfigMap（假设你有对应的configmap配置文件）
  kubectl apply -f configmap.yml -n dev-space
  # 再部署Deployment
  kubectl apply -f deployment.yml -n dev-space
  

4. RBAC权限限制（较少见） #

如果你的集群启用了RBAC，kubelet所在节点的服务账号可能没有读取目标ConfigMap的权限。这种情况通常会在日志中出现权限相关的错误提示，可以检查集群的RBAC规则，确保节点服务账号拥有get、list ConfigMap的权限。

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