ossfs lets you mount an Object Storage Service (OSS) bucket to a local directory on the Linux operating system. This enables you to manage data in the bucket in the same way you manage local files.
Version upgrade
Use OSS Connector for AI/ML for workloads including AI training, inference, and autonomous driving simulations if you prefer not to use OSS SDKs or ossfs 2.0 (preview).
Key features of ossfs 2.0:
Fundamental POSIX compatibility allows for optimized utilization of OSS's server-side I/O performance.
Efficient sequential read and write performance for large objects through end-to-end I/O path optimization.
Enhanced metadata management delivers low-latency concurrent access to small objects.
Introduction
ossfs is a Filesystem in Userspace (FUSE) based file system that lets you mount an OSS bucket to a local directory on the Linux operating system and supports the following features:
Supports most features described in POSIX standards, such as file and directory uploads and downloads, and user permission management.
Uses multipart upload and resumable upload to upload OSS objects by default.
Supports MD5 verification to ensure data integrity.
Runtime environment
ossfs is a FUSE-based file system and works only on FUSE-compatible machines. ossfs provides installation packages for Ubuntu and CentOS. To run ossfs in other environments, you need to use the source code to build the required program.
Linux
CentOS 7.0 or later.
Ubuntu 14.04 or later.
Anolis7 or later.
FUSE 2.8.4 or later
You can run the
fusermount -Vcommand to check the version of FUSE. If the value of the fusermount version parameter in the response is 2.8.4 or later, such as 2.9.2, the version of FUSE meets the requirements.
Limits
The following limits apply to ossfs when you use it to mount a bucket to a local directory on the Linux operating system:
ossfs is not suitable for scenarios that require highly concurrent read and write operations.
NoteBoth read and write operations consume disk capacity. In highly concurrent read/write scenarios, disk performance limits read and write operations.
Concurrent read and write requests compete for resources, which affects the bandwidth.
ossfs does not support hard links.
Archive, Cold Archive, and Deep Cold Archive buckets cannot be mounted to local file systems using ossfs.
If you use ossfs to edit an uploaded object, the object is re-uploaded.
The performance of metadata-related operations, such as
list directory, is compromised because you must remotely access the OSS server.Errors may occur if you rename an object or a directory. Operation failures may cause data inconsistencies.
If a bucket is mounted to multiple clients and data is simultaneously written to the mount points, ossfs does not guarantee consistency.
Make sure that your AccessKey has full permissions for the target bucket or resources whose names are prefixed with specified values. If you cannot grant full permissions, at least grant the
oss:GetObject,oss:ListObjects,oss:DeleteObject,oss:PutObject,oss:AbortMultipartUpload, andoss:ListMultipartUploadspermissions. Otherwise, ossfs mounting will fail or become abnormal.
What to do next
You can mount a bucket to a local Linux system after you install ossfs 1.0 and configure ossfs 1.0.