<think>我们正在构建过程中遇到磁盘不足，需要临时改变构建目录到其他位置，而不是永久迁移Docker根目录。 由于构建已经进行到一半，我们希望在剩余构建步骤中使用新的位置。 不能使用永久修改data-root的方法，因为那需要重启docker服务，会中断现有构建（如果还有运行中的容器也不安全）。 因此，我们采用临时设置环境变量或使用BuildKit缓存挂载的方式，或者将构建上下文复制到新位置重新开始构建。 注意：构建到一半的状态可能无法直接迁移，所以通常需要重新开始构建，但可以复用已下载的基础镜像层。 方案： 1. 清理当前磁盘空间（如果可能，但不总是可行） 2. 将整个构建上下文（包括Dockerfile）复制到另一个有足够空间的磁盘，然后在那里构建。 3. 使用BuildKit的缓存挂载特性，将缓存目录指向新位置（但需要重新开始构建）。 具体步骤： 方法A：复制项目到新位置重新构建（最简单，推荐） a. 将整个项目文件夹（包括Dockerfile和所有构建上下文文件）复制到新磁盘分区。 b. 在新位置运行docker build。 方法B：使用BuildKit并指定缓存位置（需要重新构建，但可复用部分缓存） a. 启用BuildKit，并挂载缓存目录到新位置。 b. 重新构建，之前构建的层可能会被缓存到新位置，从而继续使用。 方法C：设置临时目录环境变量（针对临时文件） a. 设置TMPDIR环境变量到新位置，这样Docker在构建过程中产生的临时文件会写到新位置。 b. 重新构建（注意：部分中间状态可能丢失，需要重新开始）。 详细步骤： 方法A（复制项目）： 1. 假设新位置是/mnt/big_disk 2. cp -r /current/project /mnt/big_disk/project 3. cd /mnt/big_disk/project 4. docker build -t myapp . 方法B（使用BuildKit缓存挂载）： 1. 确保Docker版本支持BuildKit（18.09+） 2. 在新位置创建缓存目录：mkdir -p /mnt/big_disk/cache 3. 重新构建（注意：这不会继续之前的构建，但是会尝试使用缓存，如果之前有缓存层在旧位置，可能不会用，所以可能需要先清理旧缓存？或者直接重新下载） 命令：DOCKER_BUILDKIT=1 docker build --build-arg BUILDKIT_INLINE_CACHE=1 -v /mnt/big_disk/cache:/cache -t myapp . 4. 注意：这种方法需要调整Dockerfile来利用缓存挂载，例如将下载的包缓存到/cache目录，然后在后续构建中复用。但并不是所有构建步骤都能直接利用。 方法C（设置临时目录）： 1. 创建临时目录：mkdir -p /mnt/big_disk/tmp 2. 设置环境变量：export TMPDIR=/mnt/big_disk/tmp 3. 在原来的位置重新构建：docker build -t myapp . 由于您已经构建到一半，并且磁盘不足，建议使用方法A，因为它最直接，且不会受到之前构建失败的影响（因为重新开始），同时避免了原磁盘空间不足的问题。 注意：在复制项目时，确保复制了所有必要的文件（包括.dockerignore中忽略的文件之外的）。如果构建上下文很大，复制可能需要时间。 如果之前构建已经下载了一些基础镜像，这些镜像在/var/lib/docker中，那么在新位置构建时，如果新位置是同一个Docker守护进程（即没有修改data-root），则这些基础镜像层可以复用，不需要重新下载。 因此，方法A是最简单且最有可能成功的。 详细步骤（方法A）： 1. 检查新磁盘空间：df -h /mnt/big_disk 2. 复制项目：rsync -av /path/to/project /mnt/big_disk/ （或使用cp -r） 3. 进入新目录：cd /mnt/big_disk/project 4. 开始构建：docker build -t myapp . 如果您希望保留之前构建的镜像层（但通常构建失败不会留下最终镜像，中间层可能会留下），可以尝试清理旧项目目录的构建缓存，但这不是必须的。 注意：如果构建中使用了卷（volume）或绑定挂载，确保新位置的文件路径在容器中正确。 另外，构建完成后，镜像会存储在Docker的默认存储位置（/var/lib/docker），所以构建完成后如果那个位置空间不足，可能还需要迁移整个Docker存储，或者将镜像导出保存。 但当前问题是在构建过程中，所以先解决构建时的磁盘空间。 §§相关问题§§ 1. 如何在不复制整个项目的情况下，将Docker构建的中间缓存迁移到新磁盘？ 2. 使用rsync复制大型项目时如何避免文件权限问题？ 3. 在构建过程中如何实时监控Docker占用的磁盘空间变化？ 4. 除了移动构建位置，还有哪些方法可以立即释放Docker构建占用的磁盘空间？ 5. 如何配置Docker使其构建产生的临时文件默认存储在其他分区？ </think> ### 解决 Docker 构建中途磁盘不足的应急方案 #### 核心原则 **无需停止 Docker 服务或移动现有数据**，通过实时重定向技术将剩余构建过程转移到新存储位置： ```mermaid graph TD A[当前构建卡在磁盘不足] --> B{选择转移方案} B --> C[BuildKit缓存重定向] B --> D[临时文件重定位] B --> E[分层挂载构建] C --> F[继续未完成构建] D --> F E --> F F --> G[在新位置完成构建] ``` #### 具体操作步骤 ##### 方案1：BuildKit缓存重定向（推荐） ```bash # 创建新存储位置 mkdir -p /mnt/new_disk/cache # 继续构建并重定向缓存 DOCKER_BUILDKIT=1 docker build \ --progress=plain \ --no-cache \ --build-arg BUILDKIT_INLINE_CACHE=1 \ -v /mnt/new_disk/cache:/cache \ -t myapp . ``` ##### 方案2：临时文件重定位（无需重启） ```bash # 设置临时文件目录到新位置 export TMPDIR=/mnt/new_disk/temp # 继续原构建命令（无需修改） docker build -t myapp . ``` ##### 方案3：分层挂载构建（复杂构建适用） ```bash # 创建分层构建目录 mkdir -p /mnt/new_disk/stage # 继续构建并挂载工作目录 docker build -t myapp . \ --target intermediate-stage \ -v /mnt/new_disk/stage:/build-stage ``` #### 关键注意事项 1. **构建状态保留**： - 已完成的构建层会保留在原磁盘 - 后续层将自动写入新位置 2. **路径验证技巧**： ```bash # 查看当前缓存位置 docker builder inspect --bootstrap | grep "CachePath" # 验证临时目录 docker info | grep "Docker Root Dir" ``` 3. **空间释放应急命令**： ```bash # 紧急清理当前构建残留 docker builder prune -af && \ docker rmi $(docker images -f "dangling=true" -q) ``` #### 后期永久配置 构建完成后建议永久迁移： ```bash # 停止Docker sudo systemctl stop docker # 修改配置文件 echo '{"data-root": "/mnt/new_disk/docker"}' | sudo tee /etc/docker/daemon.json # 启动服务 sudo systemctl start docker ```