P2P 与分布式存储 / 系统课时
更换磁盘怎样迁移数据仓库
更换磁盘怎样迁移数据仓库
更换磁盘的风险不仅是拷贝漏文件,还包括仓库仍在写入、路径指错和权限变更。本节用保留旧源、复制到新位置、离线验证再切换的流程,建立可以回退的仓库迁移步骤。
学习目标
- 安排停机一致性与目标路径校验。
- 在切换前保留旧仓库并验证业务内容。
生产迁移先安排窗口
记录业务根、Pin 清单、Kubo 与仓库版本,确认新磁盘空间和权限,验证独立备份可恢复。暂停写入并停止 daemon、自动启动服务和其他打开仓库的应用。以进程确实退出为准,不能只看管理界面按钮已点击。
完整复制保留节点身份,所以新旧源不能同时启动 daemon。目标先使用同版本 Kubo,路径切换和版本升级分别进行。若自定义后端引用外部绝对路径,需要迁移相应数据并调整配置,不能只复制主目录。
在新临时目录练习复制
以下 Bash 操作需 Kubo 0.43.1 和支持 cp -a 的系统,全部位于新临时目录,没有 daemon。它演示一致离线仓库复制,本节未真实执行;不表示已经完成真实跨盘或生产权限验收。
set -euo pipefail
work="$(mktemp -d)"
source_repo="$work/source-repo"
target_repo="$work/new-location/repo"
export IPFS_PATH="$source_repo"
ipfs init > /dev/null
printf 'disk-move-practice\n' > "$work/original.txt"
cid="$(ipfs --offline add -Q "$work/original.txt")"
ipfs --offline pin ls --type=recursive --quiet > "$work/roots-before.txt"
# 目标必须不存在;保留源仓库用于回退,不移动或删除源。
test ! -e "$target_repo"
mkdir -p "$work/new-location"
cp -a "$source_repo" "$target_repo"
export IPFS_PATH="$target_repo"
ipfs --offline pin ls --type=recursive "$cid"
ipfs --offline cat "$cid" > "$work/restored.txt"
cmp "$work/original.txt" "$work/restored.txt"
printf 'copied repo restore passed\n'预期结果:
<CID> recursive
copied repo restore passed小文件恢复是最低检查,还需核对全部业务根和大目录。源仍保留,但它与目标若在同一磁盘不能算独立备份。生产迁移使用实际挂载点时,应检查设备与绝对路径,避免挂载失败后把数据写到系统盘同名目录。
迁移时还要检查目标文件系统是否支持需要的文件和权限语义。跨系统复制可能改变所有者或访问控制,不能只比较目录总大小。目标的空间预算应包括本次复制、后续增量和恢复输出,并确认复制工具的退出码与错误列表。
不要把文件系统的写时复制克隆当作独立故障域。它能方便保留回退点,却可能与原仓库共享同一设备;硬盘损坏会同时影响两者。
切换路径并复核实际节点
目标验收通过后,修改服务使用的仓库路径及访问权限,再仅启动目标节点。核对 Peer ID、实际仓库路径、Pin 清单和完整恢复。终端中的 IPFS_PATH 不一定影响系统服务,要审查服务账户与启动环境,而不是重启后凭默认路径猜测。

失败时先停止目标,保留错误日志和目标副本,再恢复服务指向旧源。若切换后已有新增数据,不能直接回到旧仓库丢掉增量,应先停止业务并安排增量清单与数据恢复。旧源的保留期限应与回退窗口一致。
验收报告应记录复制范围、校验根数量、权限、实际路径与尚未执行的断电测试。参考官方迁移流程,可回退的复制和显式验证,比一条未经核对的移动命令更适合关键数据。