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

执行 GC 前该检查哪些数据

执行 GC 前该检查哪些数据

GC 一旦回收未受保护块,通常不能从本地撤销。本节把根清单、引用关系、恢复来源和磁盘余量组织成清理前检查,帮助你判断一次维护是否可以安全开始。

学习目标

  • 在清理前确认重要内容的保护与恢复证据。
  • 为错误、缺块和维护并发设置明确阻断条件。

从业务清单开始而不是从磁盘开始

先列出必须保留的业务根 CID、版本、负责人和到期规则,再与实际递归及直接 Pin 清单核对。MFS 中可达数据也需要盘点。缺少业务清单时,节点只知道哪些块受保护,不知道哪些未 Pin 内容其实仍有价值。

GC 之前必须有经过恢复验证的独立来源,可能是另一故障域的完整副本、原件备份或完整 CAR。根清单只是地址,不含内容;压缩一个清单文件不构成数据备份。备份与原仓库在同一块盘时,也无法覆盖该盘故障。

采集只读的维护快照

以下 Bash 片段依赖 Kubo 0.43.1 与已停止 daemon 的专用练习仓库。路径需替换,输出目录由新临时目录承载;本节未执行真实 Kubo。命令先收集证据,不执行 GC,也不修改保留关系。

bash
set -euo pipefail
export IPFS_PATH='/absolute/path/to/practice-repo'
audit="$(mktemp -d)"
ipfs version > "$audit/kubo-version.txt"
ipfs --offline pin ls --type=recursive --quiet > "$audit/recursive.txt"
ipfs --offline pin ls --type=direct --quiet > "$audit/direct.txt"
ipfs --offline pin verify --verbose > "$audit/pin-verify.txt"
ipfs --offline repo stat > "$audit/repo-stat.txt"
ipfs --offline files stat / > "$audit/mfs-root.txt"
df -h "$IPFS_PATH"
printf 'audit directory: %s\n' "$audit"

预期结果:

text
df显示练习仓库所在卷的容量与余量
audit directory: <AUDIT_PATH>

检查结果必须打开审阅。pin verify 有 broken 或 error 都应阻断维护,即使命令退出码为零;递归根没有进入结果也需要核对。大仓库执行完整扫描需要时间,应按窗口和资源预算安排,而不是让多个扫描同时占用磁盘。

清理许可来自条件全部满足

如果业务根未在保护清单中,先保留并恢复核验;如果有缺块,先在工作副本修复;如果没有独立恢复来源,先备份。对到期根的取消 Pin 应由明确业务规则批准,不应把“目前没人访问”当成删除依据。

清理窗口内暂停新增导入与并发保留变更,记录准备快照、实际回收输出和维护后恢复检查。自动 GC 的配置也要核对,避免手工盘点期间后台先回收尚未确认的数据。配置更改需要遵循当前版本生效时机。

空间收益也要有上限预期

如果磁盘主要由受保护内容占用,GC 可能几乎不释放空间。此时应扩容或调整生命周期,而不是反复清理。如果同卷还有备份和快照,需要单独诊断它们的占用,但不应连同恢复来源一起删除。

练习提交一份清理前审查单,列出一个通过条件和两个阻断原因,附上恢复来源的最近验收时间。参考仓库 GC 实现与配置说明。只有清单、完整性和恢复证据一致时,才进入实际维护步骤。

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

目录与阅读设置

阅读设置

17

记录一个想法

执行 GC 前该检查哪些数据

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

登录哪都通