Setup
The OCI VFS needs a bucket, the tenancy’s Object Storage namespace, the region and a Customer Secret Key pair.Create the bucket, namespace and keys
Create the bucket, namespace and keys
- In the OCI Console, open Storage > Buckets, choose the compartment
and pick Create bucket, such as
mirage. Keep the Standard tier unless archive is wanted. - Open the Profile menu > Tenancy and copy the
Object Storage namespace, such as
idsiqbdbcr4i, or runoci os ns get. - Open the Profile menu > User settings > Customer secret keys and pick Generate secret key. Copy the Secret Key right away: Oracle shows it only once. Then copy the key’s Access Key from the list.
- Give the user’s group policies such as
Allow group <group> to read buckets in compartment <compartment>andAllow group <group> to manage objects in compartment <compartment>(read objectsfor a read-only mount). - Read the region identifier from the region selector, such as
us-ashburn-1,us-phoenix-1oreu-frankfurt-1.
- The namespace and region build the endpoint
https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com, addressed path-style. - A user holds at most two Customer Secret Keys.
- A prefix such as
data/is not part of the bucket name; setkey_prefixto mount it.
Connect
- YAML
- Python
- TypeScript
workspace.yaml
Layout
- Each object key is a file path; folders are key prefixes, and the bucket holds no directory objects.
key_prefix(keyPrefixin TypeScript) mounts one subpath of the bucket as the root.grep -r,findanddustop after 1000 files; a glob matching more,tar -c,cp -randrm -rare refused.
Sample runs
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.