AWS EC2 Kubernetes集群挂载EBS卷失败问题求助

从你给出的错误信息来看，核心问题是Kubernetes集群没有正确配置AWS云提供商，导致attachdetach-controller和kubelet无法与AWS API交互完成EBS卷的挂载操作。下面是具体的排查和解决步骤：

1. 检查kube-controller-manager的云提供商配置 #

首先确认集群的kube-controller-manager组件是否启用了AWS云提供商支持：

• 查看controller-manager的启动参数：

  kubectl describe pod kube-controller-manager-<你的节点名称> -n kube-system
  

  在Command字段中，需要包含--cloud-provider=aws参数。如果没有这个参数，需要修改controller-manager的配置：
  • 如果你用kubeadm部署集群，编辑/etc/kubernetes/manifests/kube-controller-manager.yaml，在command列表中添加--cloud-provider=aws，保存后kubelet会自动重启该pod。
  • 手动部署的话，找到controller-manager的启动脚本，添加该参数后重启服务。

2. 配置kubelet的云提供商参数 #

集群中的每个EC2节点的kubelet都需要配置AWS云提供商：

• 编辑kubelet的配置文件（通常是/etc/systemd/system/kubelet.service.d/10-kubeadm.conf或者/var/lib/kubelet/config.yaml），确保启动参数包含--cloud-provider=aws。
• 重启kubelet服务：

  systemctl daemon-reload
  systemctl restart kubelet
  

3. 验证EC2实例的IAM权限 #

你的EC2实例需要具备操作EBS卷的IAM权限，否则无法完成挂载/卸载操作：

• 创建一个包含以下权限的IAM策略（可以命名为KubernetesEBSAccessPolicy）：

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ec2:AttachVolume",
                  "ec2:DetachVolume",
                  "ec2:DescribeVolumes",
                  "ec2:DescribeInstances"
              ],
              "Resource": "*"
          }
      ]
  }
  

• 将该策略关联到EC2实例的IAM角色上（如果实例还没有IAM角色，需要先创建角色并关联到实例）。

4. 检查PV配置的正确性 #

确认你的PersistentVolume(PV)配置中EBS卷的信息正确：

• 查看PV的定义，确保spec.awsElasticBlockStore.volumeID格式正确，比如：

  awsElasticBlockStore:
    volumeID: aws://us-east-2a/vol-011d7bb42da888b82
  

  注意：EBS卷必须和EC2实例处于同一个可用区，否则无法挂载。

5. 验证节点与AWS API的连通性 #

确保EC2节点能够正常访问AWS EC2 API：

• 在节点上执行以下命令测试连通性：

  curl https://ec2.us-east-2.amazonaws.com
  

  如果返回XML格式的响应，说明网络连通正常；如果不通，检查实例的安全组是否允许出站访问AWS服务（通常允许HTTPS到0.0.0.0/0即可）。

完成以上步骤后，删除现有的PV/PVC和相关Pod，重新创建，挂载操作应该就能正常执行了。

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