cache
本章节介绍 Curvine 的缓存策略以及如何缓存数据。
缓存策略
写入策略
写入策略控制挂载路径上的数据写入方式。在当前 main 分支里，它通过 cv mount ... --write-type <类型> 配置，CLI 默认值为 fs_mode。
| 策略 | CLI 取值 | 行为 | 适用场景 |
|---|---|---|---|
| CacheMode | cache_mode | 直接写到底层 UFS，Curvine 主要承担统一访问与缓存读取层 | 数据主存仍在 UFS 的场景 |
| FsMode | fs_mode（CLI 默认） | 优先写入 Curvine 命名空间；首次挂载时可能触发元数据 resync | 由 Curvine 管理缓存命名空间的场景 |
读取校验
当前面向用户的读侧校验开关是挂载参数 --read-verify-ufs：
| 策略 | 行为 |
|---|---|
| 关闭 | 信任缓存与统一文件系统默认回退逻辑 |
| 开启 | 读前按 UFS 元数据（mtime 与文件长度）校验缓存 |
当校验失败或缓存未命中时，会直接从 UFS 读取；若该挂载启用了自动缓存，可同时异步将数据加载到 Curvine。
TTL机制
TTL是Curvine中用于自动管理缓存数据生命周期的核心机制，支持文件和目录的自动过期处理。
配置
按挂载配置 TTL（推荐）
使用 cv mount 挂载 UFS 时，可为该挂载设置 TTL：
| 选项 | 类型 | 默认值 | 说明 | 示例 |
|---|---|---|---|---|
--ttl-ms | duration | 7d（挂载默认） | 缓存数据过期时间 | 24h、7d、30d |
在当前源码里，挂载点的 TTL 动作由 write_type 推导：
cache_mode挂载默认对应deletefs_mode挂载默认对应free
客户端默认值
在集群配置的 client 段（如 curvine-cluster.toml）中，可配置 ttl_ms（默认 0）和 ttl_action（默认 none），作为非挂载路径或创建文件时的默认值。
Master 节点（TTL 检查器）
在集群配置的 [master] 段中，使用以下 TOML 键：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ttl_checker_interval | duration | 1h | TTL 检查器运行间隔 |
ttl_checker_retry_attempts | u32 | 3 | TTL 操作失败时的最大重试次数 |
ttl_bucket_interval | duration | 1h | 批量处理过期 inode 的桶时间间隔 |
ttl_max_retry_duration | duration | 10m | 失败 TTL 操作的最大重试时长 |
ttl_retry_interval | duration | 1s | 重试间隔 |
动作类型
当前源码中 TTL 只有三种动作：
| 动作 | 说明 |
|---|---|
| None | 不执行操作；过期数据保留直至被显式删除或覆盖。 |
| Delete | 仅从 Curvine 删除文件或目录（不导出到 UFS）。 |
| Free | 释放缓存数据，同时保留 fs_mode 挂载下的命名空间语义。 |
执行流程
缓存方式
自动缓存
当某挂载配置了非零 TTL（例如 cv mount s3://bucket/prefix /path --ttl-ms 7d）时，即启用该挂载的自动缓存。在该挂载下首次读取某个 UFS 文件（缓存未命中）时，Curvine 会提交一个异步加载任务，将数据拉取到 Curvine；本次读取由 UFS 直接返回，任务在后台执行。
在日志中可看到类似输出：
Submit async cache successfully for s3://bucket/cache/test.log, job res CacheJobResult { job_id: 7c00853f-13c8-43c1-8b3f-44740750b5a0, target_path: /s3/cache/test.log }
可用 job_id 查询缓存任务状态：
bin/cv load-status 7c00853f-13c8-43c1-8b3f-44740750b5a0
主动缓存
可以是load命令主动加载 UFS 数据到 Curvine，示例如下：
bin/cv load s3://bucket/cache/test.log
自动缓存与主动缓存可同时使用；主动缓存可缩短该文件首次读取的等待时间。
加载数据前，须先将 UFS 挂载到 Curvine（cv mount）。
自动缓存与主动缓存均使用固定缓存路径，与 UFS 目录结构一致。