运行Localstack时遭遇镜像层注册失败错误，寻求解决方案

错误日志 #

PS D:\Localstack> docker-compose up
Pulling localstack (localstack/localstack:latest)...
latest: Pulling from localstack/localstack
e4fff0779e6d: Already exists                    
d97016d0706d: Already exists                                          
53db1713e5d9: Already exists                                          
a8cd795d9ccb: Already exists                                          
de3ba92de392: Already exists                                          
048f50fe308f: Pull complete                                           
4542e2f6b62e: Pull complete                                           
01822b90a867: Pull complete                                           
f88d1e903ef2: Pull complete                                           
6284d3eed9c9: Pull complete                                           
bf8eb48c6700: Pull complete                                           
8b00183573da: Pull complete                                           
4f4fb700ef54: Pull complete                                           
5d850abf78b3: Pull complete                                           
12ff95b82ae3: Pull complete                                           
e173c56a9dc6: Pull complete                                           
ae7a9c1d239f: Pull complete                                           
3095282ba342: Pull complete                                           
54e29c63ac7e: Extracting [==================================================>]    129MB/129MB  
72f9a0d4296a: Download complete                                       
49c58d119219: Download complete                                       
a1d9a02c5b38: Download complete                                       
76b820554a94: Download complete                                       
94bcc574166a: Download complete                                       
7878ab22a709: Download complete                                       
66384fec2e8e: Download complete                                       
c150844d7129: Download complete                                       
c147c067fef2: Download complete                                       
ERROR: failed to register layer: Error processing tar file(exit status 1): write /opt/code/localstack/.venv/lib/python3.11/site-packages/twisted/logger/__pycache__/_filter.cpython-311.pyc: no space left on device

所用docker-compose文件 #

version: '3.1'

services: 
  localstack:
    image: localstack/localstack:latest
    environment: 
      - AWS_DEFAULT_REGION=us-east-1
      - EDGE_PORT=4566
      - SERVICES=lambda,s3
    ports: 
      - '4566-4583:4566-4583'
    volumes: 
      - "${TEMPDIR:-/tmp/localstack}:/tmp/localstack"
      - "/var/run/docker.sock:/var/run/docker.sock"

已尝试的无效操作 #

• 更换多个Localstack版本
• 修改端口配置

解决方案 #

错误提示明确显示*no space left on device*，说明Docker所在磁盘分区空间不足，导致镜像层无法写入。按以下步骤处理：

1. 清理Docker冗余资源

   • 停止所有运行中的容器：docker stop $(docker ps -aq)
   • 删除所有停止的容器：docker rm $(docker ps -aq)
   • 删除未使用的镜像：docker image prune -a
   • 清理闲置卷：docker volume prune
   • 一键清理Docker系统缓存：docker system prune -a

2. 检查并释放磁盘空间

   • Windows：打开资源管理器查看Docker安装盘（多为C盘）剩余空间，确保至少有20GB以上可用，可删除系统垃圾、大文件释放空间。
   • Linux/macOS：执行df -h命令查看磁盘占用情况，定位空间不足的分区并清理冗余文件。

3. 迁移Docker存储目录（可选）
   若系统盘空间紧张，可将Docker镜像、容器的存储目录迁移到大容量磁盘：

   • Windows：在Docker Desktop设置的「Resources > Advanced」中，修改「Disk image location」到其他磁盘路径，重启Docker生效。
   • Linux：编辑/etc/docker/daemon.json文件，添加"data-root": "/path/to/large/disk/docker"，执行systemctl restart docker重启服务。

4. 调整Localstack临时挂载路径
   当前配置中临时目录默认挂载到/tmp/localstack，若该目录所在磁盘空间不足，可修改为其他有足够空间的路径：

   volumes: 
     - "D:/localstack/tmp:/tmp/localstack"  # 替换为你的大容量磁盘路径
     - "/var/run/docker.sock:/var/run/docker.sock"
   

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