rebase volume

Manage persistent file volumes mounted into deployed functions and apps.

Synopsis

rebase volume create <name>
rebase volume list
rebase volume get <name>
rebase volume ls <name> [path]
rebase volume put <name> <local-path> [remote-path]
rebase volume download <name> <remote-path> [local-path]
rebase volume rm <name> <remote-path>
rebase volume delete <name> [--force]

Subcommands

SubcommandDescription
createCreate a volume. Idempotent: returns the existing volume if the name is taken.
listList volumes in the active workspace.
getShow volume metadata (provider, bucket, prefix).
lsList files in a volume, optionally under a path prefix.
putUpload a local file or directory. Directories upload recursively.
downloadDownload one file from the volume.
rmDelete one file from the volume.
deleteDelete the volume and every file in it. Prompts unless --force.

Behavior

Volume names use lowercase letters, digits, ., _, and -. Uploads and downloads move bytes over presigned URLs directly between your machine and object storage.

Attach volumes to deployed code with the SDK:

@rb.function(volumes={"/models": rb.Volume.from_name("model-cache", create_if_missing=True)})
def train(): ...

See Volumes for the full guide.

On this page