SuperAPI AI 工具集

mount-tidb-cloud-fs

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:将已有的 TiDB Cloud Filesystem 挂载到本地目录,全过程不依赖 ti profile,也不使用 TiDB Cloud API Key。仅用于挂载已有文件系统,不用于创建、删除或管理其令牌。要求 ti v0.2.1 或更高版本;该 CLI 目前处于预览阶段,若行为有差异,可运行 ti fs mount-file-system --help 并查阅官方仓库 https://github.com/tidbcloud/ti-cli。

必要输入:TI_FS_TOKEN(Owner 或 scoped Filesystem 令牌,用于认证并识别文件系统)、TI_REGION_CODE(路由区域,例如 aws-us-east-1,也可改用 --region)、MOUNT_PATH(本地挂载目录);TI_FS_FILE_SYSTEM_ID 为可选项,仅作一致性断言。切勿打印或记录令牌。

主要流程:校验输入;若未安装 ti 则通过官方 install.sh 安装并更新 PATH,再用 ti --version 确认版本,过旧则 ti update;创建挂载目录(优先新目录或空目录);按平台选择驱动——Linux 仅用 FUSE、禁止 WebDAV,macOS 自动使用 macFUSE 或系统 WebDAV,Windows 本地挂载在 v0.2.3 中不受支持;Linux 缺少 fusermount3/fusermount 时应先尝试安装 fuse3 并确认 /dev/fuse 存在;随后执行 ti fs mount-file-system --mount-path "$MOUNT_PATH" --driver "$mount_driver" --ready-timeout 60s,挂载在后台运行并在就绪后返回,可加 --read-only、--foreground、--query、--output;挂载后用 ls 验证,写入预期时可创建唯一探测文件,只读或无权写入时跳过;结束后用 ti fs unmount-file-system --mount-path "$MOUNT_PATH" 卸载。

限制与排障:缺少区域即使令牌有效也会失败;提供的文件系统 ID 必须与令牌推导出的 ID 一致;scoped 令牌只能访问其允许的路径和操作,不应默认可写;Linux 上不要因缺少 FUSE 工具就放弃,也不要改用 WebDAV;后台挂载超时可查看 ti 报告的日志路径并以 --foreground 重试。