缓存加速 CLI 命令

如果 CloudFS 实例开启了缓存加速，支持使用 CLI 命令。本文介绍在缓存加速场景常用的 CLI 命令的使用方式。

ls

CLI 列举文件，使 CloudFS 同步 TOS 上的元数据。列举的path可以填写本地挂载路径的子路径，或者挂载 TOS 的子路径。

SYNOPSIS
    cfs ls [OPTION] <path>
    
DESCRIPTION
    -R, --recursive
            递归列举子目录
        --depth
            配合"-R"使用，表明 list 路径深度。"0"表示仅 list 当前路径，"1"表示 list 当前路径及其子路径，以此类推。默认值为 32767。
        --concurrency
            递归列举子目录最大并发量。默认值为 100。
        --config-file
            配置文件路径。

如果超过 30 秒没有打印 list 结果，会打印当前已经 list 的文件数量以提示进度。示例如下：

1327202 paths have been listed as of Dec 21 10:37:06

load

将底层文件系统的元数据或数据加载至 CloudFS 缓存。

SYNOPSIS
    cfs load [OPTION] <path>
    命令执行后会返回 JOB ID，该 JOB ID 用于之后查询任务状态。
    
DESCRIPTION
    -d, --data
            将数据从底层文件系统加载至 CloudFS 缓存。
    -m, --metadata
            将元数据从底层文件系统加载至 CloudFS 缓存。
    -r, --recursive
            递归加载数据或元数据。
        --replica
            加载数据的副本数，默认为 1。
        --config-file
            配置文件路径。

free

释放 CloudFS 中的数据或元数据。该命令不会影响底层文件系统的数据。

SYNOPSIS
    cfs free [OPTION] <path>
    命令执行后会返回 JOB ID，该 JOB ID 用于之后查询任务状态。
    
DESCRIPTION
    -m, --metadata
           释放 CloudFS 元数据。
    -r, --recursive
            递归释放数据或元数据。
        --config-file
            配置文件路径。

lookup

查询任务状态。

SYNOPSIS
    cfs lookup <job ID>
 
DESCRIPTION  
        --config-file
            配置文件路径。

cancel

取消任务。

SYNOPSIS
    cfs cancel <job ID>

DESCRIPTION
        --config-file
            配置文件路径。

du

展示 CloudFS 中路径缓存使用的统计值。

SYNOPSIS
    cfs du [OPTION] <path>
    
DESCRIPTION
    -h, --human-readable      
    -s, --summarize
            对指定路径进行汇总显示。
        --config-file
            配置文件路径。