P2P 与分布式存储 / 系统课时

取消 Pin 后数据何时可回收

取消 Pin 后数据何时可回收

取消 Pin 后文件还可以打开,通常不是命令无效。本节区分撤销保留关系、GC 扫除与再次联网获取,用独立离线仓库观察生命周期,避免把一次读取成功误当成内容仍受保护。

学习目标

  • 解释取消 Pin 为什么不立即删除块。
  • 在备份与引用盘点之后安全观察 GC 结果。

撤销保留与删除是两件事

pin rm 撤销指定 Pin,块通常仍在仓库中。它只有在不受其他递归根、直接 Pin、MFS 等保留机制保护时,才具备被 GC 清理的条件。GC 清的是可回收块,不是按文件名逐个删除文件,因此共享后代不一定随某个根一起消失。

在线 cat 可能在本地缺块后重新从网络取回,网关也可能命中缓存。要观察本地清理行为,需要关闭这些替代来源。本节使用离线命令和独立仓库,不借助删块目录来制造故障。

取消Pin到块回收的生命周期

仅在练习仓库运行清理

环境为 Bash 与 Kubo 0.43.1,命令未在本节真实执行。原文件保留在仓库外,这就是本例的恢复来源;不要把下面的 repo gc 挪到未备份的生产仓库。

bash
set -euo pipefail
export IPFS_PATH="$(mktemp -d)"
work="$(mktemp -d)"
ipfs init > /dev/null
printf 'gc-lifecycle-unique\n' > "$work/original.txt"
cid="$(ipfs --offline add -Q "$work/original.txt")"
ipfs --offline pin rm "$cid"
# 清理前确认仍能读,再执行这个练习仓库的GC。
ipfs --offline cat "$cid" > "$work/before.txt"
cmp "$work/original.txt" "$work/before.txt"
ipfs --offline repo gc
if ipfs --offline cat "$cid" > "$work/after.txt" 2> "$work/after.err"; then
  printf 'still locally readable: inspect shared retention\n'
else
  printf 'not locally readable after gc\n'
fi

预期结果:

text
unpinned <CID>
removed <BLOCK_CID>
not locally readable after gc

GC 可能输出多行 removed 或没有回收项,块 CID 与根 CID也不必相同。在这个独立案例、无其他引用的条件下应出现本地读取失败;若仍成功,应盘点引用和命令实际连接目标,不能为了符合预期继续强删块。

如果计划取消目录根,先保存该根与业务版本的对应关系,并验证另一来源能恢复整个目录。只确认远端有根块会漏掉后代缺失;本地一旦清理,原本可用的缺块来源可能就不存在了。

实验后需要恢复时,应重新从仓库外原文件导入并核对导入方式,再检查保留清单。不是把 GC 输出中的每一个块逐个重新 Pin,因为那会混淆业务根和存储块,且无法自动重建业务目录。

清理还应与自动任务串行安排。新的导入、MFS 写入和人工取消保留可能改变引用集合,运维人员要记录维护窗口内的变更,避免前后容量差来自其他任务却被计入本次释放量。

回收失败与磁盘释放分别观察

GC 非零退出可能意味着部分清理已经发生,应保存完整输出,不要假设它是全有或全无的事务。仓库统计减少与文件系统可用空间增加也可能不同时出现,取决于后端回收、文件系统快照和打开文件句柄。

练习写出三种不该取消 Pin 的情况:只有唯一副本、没有恢复来源、尚有业务引用。对生产数据,先核对到期规则和独立副本恢复证据,再安排维护窗口。依据见GC 标记实现和Pin 撤销实现,清理验收不能仅看一条成功提示。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

取消 Pin 后数据何时可回收

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通