如何为AWS Beanstalk部署的Docker容器挂载EFS卷并解决挂载错误

问题分析 #

从错误日志来看，挂载EFS时出现超时及mount.nfs4: Connection reset by peer错误，核心原因是EC2实例与EFS之间的网络连通性受阻，或权限、配置不匹配。

排查与修复步骤 #

• 校验网络与安全组配置

  • 确认EFS与Elastic Beanstalk的EC2实例处于同一VPC，且EFS已在EC2所在子网创建了可用的挂载目标。
  • 检查EC2实例安全组：需允许出站NFS端口（2049）流量指向EFS安全组。
  • 检查EFS安全组：需允许入站NFS端口（2049）流量来自EC2实例的安全组。

• 确认EFS挂载目标状态

  • 登录AWS控制台查看EFS的挂载目标，确保所有关联子网的挂载目标均处于可用状态，若有异常则重新创建对应挂载目标。

• 安装NFS客户端工具

  • Elastic Beanstalk默认可能未预装NFS客户端，需在.ebextensions配置中添加安装命令：
    • 对于Amazon Linux 2：通过yum安装nfs-utils
    • 对于Ubuntu：通过apt安装nfs-common

• 修正挂载命令与权限

  • 核对挂载命令中的EFS文件系统ID（日志中为fs-0b8e45325rt8e3647），确保无拼写错误。
  • 挂载完成后，需将容器内的/usr/local/myapplication/localstorage/路径绑定到/efs下的对应目录（例如在Docker运行参数中添加-v /efs/config:/usr/local/myapplication/localstorage/）。

• 调整挂载超时参数

  • 在挂载命令中延长超时时间，避免因网络延迟导致失败：

    mount -t efs -o tls,timeo=600 fs-0b8e45325rt8e3647:/ /efs
    

示例：Elastic Beanstalk EFS挂载配置文件（.ebextensions/efs-mount.config） #

packages:
  yum:
    nfs-utils: []

commands:
  01_create_mount_point:
    command: "mkdir -p /efs"
  02_mount_efs:
    command: "mount -t efs -o tls,timeo=600 fs-0b8e45325rt8e3647:/ /efs"
  03_configure_fstab:
    command: "echo 'fs-0b8e45325rt8e3647:/ /efs efs defaults,tls,timeo=600 0 0' >> /etc/fstab"

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