Elastic Beanstalk上Docker thin pool满致容器只读，磁盘扩容未生效

• 容器反复进入只读状态的触发逻辑：Docker基于devicemapper存储驱动运行时，当thin pool剩余可分配数据块低于系统设定的安全阈值，会自动触发只读保护机制，避免磁盘写满后出现数据损坏；重新部署应用的操作只是临时清理了无效的镜像层、停止容器的残留层，释放了少量thin pool空间，没有从根本上解决容量不足的问题。
• 此前两份配置不生效的核心原因：
  • 设备名匹配错误：Elastic Beanstalk 基于Amazon Linux 2的新版Docker平台，根卷及Docker存储对应的实际块设备为/dev/xvda，配置中填写的/dev/xvdcz是旧版EB环境的专属Docker卷设备名，当前平台下不存在对应块设备，配置自然无法生效。
  • 传参格式错误：option_settings下的简单键值对格式无法正确解析块设备映射的嵌套结构，EC2 Auto Scaling启动配置并不支持这种扁平化的BlockDeviceMappings传参方式。

1. 编写符合EB资源定义规范的磁盘扩容配置 #

在项目根目录的.ebextensions文件夹下新建01-expand-root-volume.config，通过CloudFormation资源定义的方式直接修改Auto Scaling启动配置的块设备映射，不要使用option_settings的传参方式：

Resources:
  AWSEBAutoScalingLaunchConfig:
    Type: AWS::AutoScaling::LaunchConfiguration
    Properties:
      BlockDeviceMappings:
        - DeviceName: /dev/xvda
          Ebs:
            VolumeSize: 150
            VolumeType: gp3
            DeleteOnTermination: true

配置说明：这里的容量可以根据实际业务的镜像大小和可写层写入量调整，生产环境建议至少给thin pool预留100G以上的可用空间。

2. 调整Docker thin pool的空间分配规则 #

仅扩大根卷大小不会自动提升thin pool的可用容量——devicemapper驱动默认会将thin pool的数据卷限制为磁盘总容量的50%，剩余空间被划给系统分区使用。需要新增配置让Docker存储配置脚本自动将空闲空间分配给thin pool：
在.ebextensions文件夹下新建02-configure-docker-storage.config：

files:
  "/etc/sysconfig/docker-storage-setup":
    content: |
      DEVS=/dev/xvda
      DATA_SIZE=90%FREE

3. 部署验证 #

配置提交后执行EB部署操作，新启动的弹性伸缩实例会自动加载配置：

• 登入实例执行lsblk确认磁盘总容量已经达到设定值
• 执行docker info查看Storage Driver段的Data Space Total值，确认thin pool容量已经按90%的比例完成分配

• 定期清理无效容器层：在应用的部署钩子中加入每周一次的清理任务，执行docker system prune -af --volumes删除悬空镜像、停止的容器和无用的缓存卷，避免无效数据长期占用thin pool空间。
• 避免持久化数据写入容器可写层：有持久化需求的目录（比如日志、上传文件路径）要直接挂载到主机EBS卷上，不要存在容器内部，减少thin pool的无效写入。
• 确认thin pool运行模式：检查docker info输出，确保devicemapper是direct-lvm模式而非loop-lvm模式——loop-lvm模式通过文件模拟块设备，性能差且容量上限低，不适合生产环境使用。

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