ti fs unmount-file-system

Gracefully flushes and unmounts a background mount. The command alias is ti fs umount.

Syntax

ti fs unmount-file-system
  --mount-path <string>
  [--dry-run]
  [--force]
  [--help]
  [--ignore-absent]
  [--no-auto-pack]
  [--pack-archive-path <string>]
  [--timeout <duration>]
  [--version]

Options

• --mount-path <string>: The local mounted path. [required]
• --dry-run: Validate the request without applying changes.
• --force: Kill the mount process if graceful unmount times out. This can lose uncommitted in-memory or write-back state.
• --help: Display help information.
• --ignore-absent: Return success when no file system mount state exists for the specified path.
• --no-auto-pack: Skip the default auto-pack action configured by the mount. The built-in portable profile enables this action by selecting / as its pack path.
• --pack-archive-path <string>: After unmounting, pack the mount's local overlay to this remote archive path. Specifying this option requests a pack even when the mount profile has no default pack paths.
• --timeout <duration>: Time to wait for the mount process to exit. [default: 30s]
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Unmount a Filesystem:

  # Gracefully flush pending writes and detach the Filesystem mount.
  ti fs unmount-file-system --mount-path /path/to/workspace
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference