Docker实战系列之Root目录迁移指南：单机环境下的完整实践

Docker实战系列之Root目录迁移指南：单机环境下的完整实践

引言

在使用 Docker 的过程中，有时我们需要将 Docker 的 root 目录（通常包含所有容器、镜像和卷数据）迁移到新的位置。这可能是因为：

• 系统磁盘空间不足，需要将 Docker 数据移到更大的存储设备
• 想要将 Docker 数据存储在特定的高速存储设备上
• 系统重装或迁移需要保留 Docker 数据
• 性能优化，需要将 Docker 数据放在不同的文件系统上

本文将详细介绍在单机环境下如何安全地迁移 Docker root 目录。

查看当前 Docker Root 目录

首先，我们需要确认当前 Docker root 目录的位置。可以通过以下几种方式查看：

使用 docker info 命令

docker info | grep "Docker Root Dir"

默认情况下，Docker root 目录通常位于 /var/lib/docker。

迁移前的准备工作

在开始迁移之前，请确保：

1. 备份重要数据：虽然迁移过程相对安全，但备份仍然是必要的
2. 停止所有容器：确保没有正在运行的容器
3. 停止 Docker 服务

# 停止所有运行中的容器
docker stop $(docker ps -q)

# 停止 Docker 服务
sudo systemctl stop docker

Docker Root 目录迁移步骤

步骤 1：创建新的 Docker Root 目录

假设我们要将 Docker root 目录迁移到 /mnt/docker-data：

# 创建目标目录
sudo mkdir -p /mnt/docker-data

# 设置正确的权限（通常为 root 用户）
sudo chown root:root /mnt/docker-data
sudo chmod 755 /mnt/docker-data

步骤 2：复制现有 Docker 数据

使用 rsync 进行数据复制，确保保留所有权限和属性：

# 复制 Docker 数据（假设原目录为 /var/lib/docker）
sudo rsync -avz /var/lib/docker/ /mnt/docker-data/

复制完成后，验证数据完整性：

# 比较两个目录的大小
du -sh /var/lib/docker
du -sh /mnt/docker-data

步骤 3：配置 Docker 使用新的 Root 目录

方法一：修改 daemon.json 配置文件

# 创建或编辑 /etc/docker/daemon.json
sudo tee /etc/docker/daemon.json > /dev/null <<EOF
{
  "data-root": "/mnt/docker-data"
}
EOF

方法二：修改 systemd 服务文件

如果不使用 daemon.json，也可以直接修改 systemd 服务文件：

# 编辑 Docker 服务文件
sudo systemctl edit docker

在编辑器中添加：

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd --data-root=/mnt/docker-data

步骤 4：重启 Docker 服务

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启动 Docker 服务
sudo systemctl start docker

# 验证服务状态
sudo systemctl status docker

步骤 5：验证迁移结果

# 检查 Docker root 目录是否已更改
docker info | grep "Docker Root Dir"

# 验证现有镜像和容器是否仍然可用
docker images
docker ps -a

# 测试创建新容器
docker run --rm hello-world

清理工作

迁移成功后，可以删除旧的 Docker 目录：

# 谨慎操作！确保新目录工作正常后再删除
sudo rm -rf /var/lib/docker