Skip to main content
An existing bucket on a Ceph Rados Gateway (RGW) becomes a folder tree, with one file per object.

Setup

RGW signs S3 requests with an RGW user’s key pair. On a host with radosgw-admin access, create the user:
Copy access_key and secret_key from the keys block of the output; radosgw-admin user info --uid=mirage prints them again. If a key holds a \ JSON escape, remove the backslash or generate a new key.
  • RGW is self-hosted, so the endpoint is required and requests are path-style.

Connect

workspace.yaml

Layout

  • Each object key is a file path; folders are key prefixes, and the bucket holds no directory objects.
  • key_prefix (keyPrefix in TypeScript) mounts one subpath of the bucket as the root.
  • grep -r, find and du stop after 1000 files; a glob matching more, tar -c, cp -r and rm -r are refused.

Sample runs

On a write mount, redirects, cp, mv and rm change objects in the bucket. For write: conditional, see S3-compatible VFSes.

SDK guides

Python

Every config field, the VFS.md and write support.

TypeScript

Every config field, the VFS.md and write support.