Object Storage Service:Use ossfs to mount an OSS bucket to a local directory on the Linux operating system

Prerequisites

• You have registered an Alibaba Cloud account.

• You have activated OSS and created an OSS bucket.

Install ossfs 2.0

Configure ossfs 2.0

In practical use, to meet the mounting requirements of OSS buckets in different scenarios, you need to configure the ossfs 2.0 configuration file specifically. Then when mounting the OSS bucket, you can reference this configuration file to complete the mounting.

1. Create a RAM user AccessKey with OSS management permissions.

   Quickly create a RAM user with OSS management permissions and its AccessKey through ROS script

   1. On the Create Stack page of the Resource Orchestration Service (ROS) console, select the confirmation under Security Confirmation, and then click Create.

      

   2. After creation is complete, copy the newly created AccessKey in the Outputs.

      

2. View the bucket's endpoint.

   Go to the Bucket List page, select the target bucket and enter it, then click Overview in the left navigation bar. You can view the region of the target bucket in the Access Points section on the overview page. As shown in the figure, using a bucket in the Hangzhou region as an example.

   

3. Create an ossfs 2.0 configuration file.

   You can freely set the file name and path of the ossfs 2.0 configuration file as needed. For example, create a /etc/ossfs2.conf file as the configuration file.

   sudo touch /etc/ossfs2.conf

4. Fill in the mounting information. Taking the read-only mounting of an entire bucket as an example.

   Open the created ossfs 2.0 configuration file, configure it according to the following example (using the Hangzhou region internal endpoint as an example), and save it. Internal and OSS accelerator endpoints only support mounting instances within the same region's VPC, providing faster and more stable data transmission. Using the public endpoint to access ossfs is not recommended because it may cause various stuttering issues due to high latency and unstable Internet connections.

   # Bucket endpoint (region node)
   --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
   
   # Bucket name
   --oss_bucket=bucketName
   
   # RAM user AccessKeyId and AccessKeySecret
   --oss_access_key_id=LTAI******************
   --oss_access_key_secret=8CE4**********************
   
   # Mount in read-only mode
   --ro=true

Mount and access

1. Create a mount directory.

   You can freely set the file name and path of the mount directory as needed. For example, create a /tmp/ossfs2-bucket directory as the mount directory.

   mkdir /tmp/ossfs2-bucket

2. Execute the mount command.

   Execute the command to mount the bucket configured in the ossfs 2.0 configuration file ossfs2.conf in read-only mode to the local /tmp/ossfs2-bucket/ directory. If you need to use read-write mounting, remove the --ro=true option from the ossfs2.conf configuration file.

   ossfs2 mount /tmp/ossfs2-bucket/ -c /etc/ossfs2.conf 

3. Operate the mounted bucket.

   After mounting is complete, you can operate on objects in the bucket as if you were accessing a local file system. For example, execute the sudo ls -lh /tmp/ossfs2-bucket/ command to view the file list of the mounted bucket.

   

4. Unmount the mounted bucket.

   If you no longer need to mount this bucket, you can execute the following command to unmount it.

   sudo umount /tmp/ossfs2-bucket/ 

References

• Overview of ossfs 2.0.

• Configure ossfs 2.0.

• ossfs 2.0 mounting options.

• Mount an OSS bucket to a local system using ossfs 2.0.