Table of Contents

多载体/管线/快照

分册导航:virtual-file-system.md | virtual-carrier.md | virtual-usage.md | virtual-operations.md | 载体与格式化 | 日常使用与常见配方 | 多载体/管线/快照

5. 多载体卷(扩容/缩容/降级)

// 在线扩容(加载体——纯加法,不改格式)
fs.AddCarrier(TierVolumeCarrier.File("/data/vol2.tier"), capacityBytes: 20L << 30);
// 设备成员容量自几何,省略 capacityBytes

// 缩容(减载体)——非空成员自动迁移(btrfs device remove 同构)后摘除
fs.RemoveCarrier(1);    // 主载体(成员 0)不可移除

// 多载体打开(全量清单——路径不入盘上格式,LVM 同构)
using var fs2 = TierVolumeFs.Open(new TierVolumeCarrier?[]
{
    TierVolumeCarrier.File("/data/vol.tier"),      // 成员 0 = 主载体
    TierVolumeCarrier.File("/data/vol2.tier"),
});

// 降级打开(成员缺失——只读形态;缺失成员上的数据读诚实拒绝)
using var fs3 = TierVolumeFs.Open(new TierVolumeCarrier?[]
{
    TierVolumeCarrier.File("/data/vol.tier"),
    null,                                   // 占位缺失成员
}, new TierVolumeOpenOptions { AllowDegraded = true });
  • 成员容量 64 块对齐;误并入已格式化载体显式拒绝;
  • 缩容含数据迁移时为逐文件逐 extent 块搬迁(在线/崩溃重放同构);
  • FreeSpace/TotalSpace 全成员求和;
  • v2 后续:>8 成员、条带布局。

6. 采集/还原/迁移(管线 + dd 快道)

全部经 RootSpaceImage(KernLab.Tier.Core.IO.Image)——只认 IFileSystem 接口平面,四态(Mem/Disk/Remote/TierVolume)互转一套代码:

// 采集 → TCA1 流(结构化存档:清单 + 数据帧 + CRC)
using (var out_ = File.Create("backup.tca"))
    RootSpaceImage.Capture(fs, out_, new ImageOptions
    {
        Compression = ImageCompression.Zstd,   // None / ZLib / Zstd
        FrameBytes = 1 << 20,
        QuietSource = true,                    // 自动进维护门闩(静默快照)
    });

// 还原(目标必须为空)
using (var in_ = File.OpenRead("backup.tca"))
    RootSpaceImage.Restore(in_, targetFs, new ImageOptions { VerifyChecksums = true });

// 文件系统间转移——能力位自动路由:
// 源与目标都置位 ContiguousCapture(即 TierVolume↔TierVolume)→ dd 字节直拷快道;
// 其余组合 → 结构化管线(TCA1 流中转)
RootSpaceImage.Transfer(sourceFs, targetFs);
  • TCA1 保真:稀疏(洞不搬零)、unwritten 区间(预分配语义重建)、FileExtra;时间戳仅审计记录不承诺还原;
  • 快道前置:容量预检(目标不足抛 DiskFull 且零字节受损)、双侧维护租约、镜像后目标重载内存态;
  • .tier 文件本身即存档——cp/dd/网络推流都是合法迁移(单工件自描述)。

7. 快照、增量与快照挂载(卷内建时点视图)

TierVolume 把「时点视图」内建为卷能力:快照 = 卷在某时刻的只读命名视图(持久在卷上,重开仍在); 增量(delta) = 两个时点之间的 op 级变更流(导出/重放到副本);快照挂载 = 把任一快照作为只读卷打开, 与活卷并发。三者共享同一套基础:检查点元数据镜像 + 冻结分配位图。

7.1 快照(CreateSnapshot / DeleteSnapshot / ListSnapshots)

var info = fs.CreateSnapshot("rel-2026-10-01");
// info.Name / info.CaptureTime / info.CaptureLsn(增量导出基点)/ info.ImageCrc(镜像强锚)

foreach (var s in fs.ListSnapshots()) { }        // 捕获序枚举(持久——重开卷后仍在)
fs.DeleteSnapshot("rel-2026-10-01");             // 删除(差集对账——仅独占块还位图)

语义与约束:

项 契约
命名 非空、UTF-8 ≤32B、不含 /、卷内唯一;重名抛 AlreadyExists
前置 须日志卷 + 可写卷(只读/无日志卷抛 Unsupported);上限 16 条(满抛 IOFailure)
捕获 = 检查点 + 冻结位图 一次元数据检查点(原子翻转生效)+ 冻结分配位图副本;无引用计数、无全量拷贝——捕获 O(元数据)
写时复制 写路径命中快照冻结块强制 CoW;释放路径钉块过滤(快照引用块不还位图)——活卷任意写不毁快照
删除 差集对账:仅本快照独占的冻结块才还位图;有活跃挂载实例拒删(SharingViolation)
与多载体互斥 快照表非空时 AddCarrier 被拒(快照引用全局块号)——先删快照再加载体
崩溃安全 创建/删除走 journal(重放幂等)——崩溃两侧自洽

7.2 快照挂载(只读并发视图)

// 活卷照常读写;同时把快照作为只读卷打开——零锁并发(共享读开口,不取跨进程锁)
using var mount = TierVolumeFs.Open(TierVolumeCarrier.File("/data/vol.tier"),
    new TierVolumeOpenOptions { Access = AccessMode.Read, SnapshotName = "rel-2026-10-01" });
using (var h = mount.Open("docs/hello.txt", new FileOpenOptions { Access = AccessMode.Read }))
    h.Read(0, buf);                              // 读到的是捕获时刻的内容
项 契约
入口 TierVolumeOpenOptions.SnapshotName(非空 = 快照挂载;必须与 Access = Read 组合——快照挂载恒只读,ReadWrite 抛 ArgumentException)
并发 与活卷写者并发安全(冻结纪律保证读面稳定);文件载体不取 .lock、设备载体共享读开口不锁卷
限定 仅单载体卷(快照位图引用全局块号,多成员卷抛 Unsupported);每快照一挂载实例(重复挂载 SharingViolation)
组合 快照挂载是普通 IFileSystem——RootSpaceImage.Capture(mount, …) 采集某时点存档、Transfer 迁移,全部能力位可用

7.3 增量(ExportDelta / ApplyDelta——op 级变更流)

var snap = src.CreateSnapshot("s-base");
var delta = new MemoryStream();
var summary = src.ExportDelta(delta, snap.CaptureLsn);   // 基点 = 快照 CaptureLsn 或 fs.JournalCheckpointLsn
// summary.RecordCount / BaseLsn / EndLsn

// 副本侧:dd 副本 = 快照时刻全量基座(保卷身份)→ 增量重放收敛到源当前态
File.Copy("/data/vol.tier", "/data/replica.tier");
using var replica = TierVolumeFs.Open(TierVolumeCarrier.File("/data/replica.tier"));
replica.ApplyDelta(new MemoryStream(delta.ToArray()));
项 契约
内容 (baseLsn, 已提交头] 的 journal 记录流 + 窗口内脏块数据段——导出体积 ∝ 变更量,无数据面全量扫描
基点 快照 CaptureLsn(携带镜像 CRC 强锚)或检查点 JournalCheckpointLsn;baseLsn < CkptLsn 拒导(窗口已被检查点截断——先做全量);崩溃恢复后窗口不完整拒导
链路增量 ApplyDelta 提交后 CkptLsn 前进——连续「导出(基点=上次末端)→ 重放」逐段收敛,链路可续
边界 须日志卷、非降级;增量流不含快照表记录(快照 = 卷本地存档视图,非复制对象)
静默纪律 导出须静默源卷——管线入口 RootSpaceImage.ExportDelta/ApplyDelta 已自动进维护门闩(非 IJournaledVolume 介质抛 Unsupported)

7.4 从快照派生新卷(无 fork 专用 API 的组合配方)

  1. 时点存档:快照挂载 → RootSpaceImage.Capture(mount, …) → Restore 到任意 fs(§6 管线);
  2. 保身份副本:File.Copy 卷文件(dd 副本 = 全量基座)→ 副本 ApplyDelta 重放到任意基点之后;
  3. 链路增量:连续 Export/Apply 逐段收敛(上表)。

.tier 单工件自描述——上述全部走公开面,无侧门(§10 规范 1)。


13. 测试与验证

  • 契约测试族 tests/KernLab.Tier.Core.Tests/IO/TierVolume/(1:1 跟源文件走);
  • 性能基准 benchmarks/Kernlab.Tier.Core.Benchmarks/IO/TierVolumeIoBenchmarks.cs(dotnet run -c Release -- --filter *TierVolumeIo*);
  • 探针 probes/DiskVsRawProbe/(快速肉眼对照);
  • 数字与验收线见 perf/io-performance.md。