AWS EKS Fargate集群Pod Pending问题求助：PVC未绑定及卷类型不支持

从你给出的kubectl describe事件信息来看，两个Pending的Pod分别遇到了PVC未绑定和不支持的卷类型问题，这都是Amazon EKS Fargate环境下常见的存储配置问题，下面分别给出分析和解决步骤：

一、MySQL Pod：PVC未绑定导致Fargate调度失败 #

Fargate调度器拒绝MySQL Pod的核心原因是mysql-db对应的PVC处于未绑定（Pending）状态——Fargate无法为没有绑定PV的Pod分配计算资源。解决步骤如下：

1. 检查集群的StorageClass配置
   首先确认集群中存在支持动态PV创建的StorageClass（AWS EBS对应的StorageClass是Fargate兼容的）：

   kubectl get storageclass
   

   如果输出中没有默认的StorageClass（无(default)标记），你需要创建一个AWS EBS的StorageClass，示例YAML如下：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: gp3
     annotations:
       storageclass.kubernetes.io/is-default-class: "true"
   provisioner: ebs.csi.aws.com
   parameters:
     type: gp3
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   volumeBindingMode: WaitForFirstConsumer
   

   应用配置：kubectl apply -f <sc-file>.yaml

2. 验证并修复MySQL PVC配置
   查看目标命名空间下的PVC状态：

   kubectl get pvc -n <你的Fargate命名空间>
   

   如果mysql-db的状态是Pending，检查它的YAML是否满足以下要求：

   • 指定了正确的storageClassName（和上面创建的SC名称一致，或使用默认SC）
   • accessModes设置为ReadWriteOnce（EBS卷仅支持单节点挂载，符合Fargate Pod的调度逻辑）
   • 合理设置了resources.requests.storage（比如10Gi）

   示例正确的PVC配置：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: mysql-db
   spec:
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
     storageClassName: gp3
   

   更新PVC配置后，等待几分钟，PV会被动态创建并绑定到PVC，此时MySQL Pod应该会被Fargate正常调度。

二、Nginx Pod：不支持的卷类型导致调度失败 #

Fargate对卷类型有严格限制，不支持hostPath、local卷这类依赖宿主机的存储类型，从错误信息来看admin-panel正是这类不兼容的卷。根据你的使用场景，选择以下解决方案：

场景1：admin-panel存储静态网页/配置（无需持久化或小量内容） #

可以使用ConfigMap存储静态内容，然后挂载到Pod中：

1. 将/var/www/html下的文件导入ConfigMap：

   kubectl create configmap admin-panel-content --from-file=./path/to/your/html/files -n <你的命名空间>
   

2. 修改Nginx的Deployment YAML，将admin-panel卷替换为ConfigMap类型：

   volumes:
     - name: admin-panel
       configMap:
         name: admin-panel-content
   

3. 重新应用Deployment配置：kubectl apply -f <nginx-deployment>.yaml

场景2：admin-panel需要持久化存储（多Pod共享或长期保存） #

使用Amazon EFS作为持久化存储（EFS支持多Pod共享挂载，适合Nginx这类可能横向扩展的服务）：

1. 在AWS控制台创建EFS文件系统，确保它和EKS集群在同一个VPC下，且Fargate Pod的安全组能访问EFS的NFS端口（2049）。
2. 创建EFS对应的StorageClass和PVC：

   # EFS StorageClass
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: efs-sc
   provisioner: efs.csi.aws.com
   ---
   # EFS PVC
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: admin-panel-pvc
   spec:
     accessModes:
       - ReadWriteMany
     storageClassName: efs-sc
     resources:
       requests:
         storage: 5Gi
   

3. 修改Nginx的Deployment YAML，将admin-panel卷替换为PVC类型：

   volumes:
     - name: admin-panel
       persistentVolumeClaim:
         claimName: admin-panel-pvc
   

4. 重新应用Deployment配置，等待Pod调度。

额外检查：Nginx的nginx-conf卷 #

如果nginx-conf是ConfigMap或Secret类型，那它是Fargate支持的；如果是其他不兼容类型，也需要按照上述方式替换。

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