Object Storage Service:Mount an OSS bucket to a Linux system by using ossfs

Prerequisites

• You have registered an Alibaba Cloud account.

• You have activated OSS and created a bucket.

Operating environment

ossfs 2.0 is based on Filesystem in Userspace (FUSE).

Install ossfs 2.0

Configure ossfs 2.0

To support different mounting scenarios, you must configure the ossfs 2.0 configuration file. You can then reference this configuration file when you mount a bucket.

1. Create an AccessKey pair for a RAM user that has OSS management permissions.

   You can use a ROS script to quickly create a RAM user with OSS management permissions and an AccessKey pair.

   1. In the ROS console, go to Create Stack. Under Security Confirmation, select the check box, and then click Create.

      

   2. After the stack is created, copy the new AccessKey pair on the Output tab.

      

2. Set the environment variables for your OSS credentials.

   export OSS_ACCESS_KEY_ID=LTAI******************
   export OSS_ACCESS_KEY_SECRET=8CE4**********************

3. You can use any name and path for the ossfs 2.0 configuration file. For example, create a file named /etc/ossfs2.conf.

   sudo touch /etc/ossfs2.conf

4. Enter the mount information. The following example shows how to mount an entire bucket in read-only mode.

   Note

   To view the endpoint of a bucket, go to the Buckets page, select the target bucket, and then click Overview in the left-side navigation pane. The endpoint is displayed in the Port section. The following examples use a bucket in the China (Hangzhou) region.

   The endpoints for a bucket in the China (Hangzhou) region are as follows: The public endpoint is oss-cn-hangzhou.aliyuncs.com. The internal endpoint for access from an Elastic Compute Service (ECS) instance in the classic network or a Virtual Private Cloud (VPC) is oss-cn-hangzhou-internal.aliyuncs.com. The transfer acceleration endpoint for global uploads and downloads is oss-accelerate.aliyuncs.com. The OSS accelerator endpoint is cn-hangzhou-internal.oss-data-acc.aliyuncs.com. All endpoints support HTTPS.

   Open the ossfs 2.0 configuration file that you created. Configure the file by using the following example, which uses an internal endpoint for the China (Hangzhou) region, and then save the file. For faster and more stable data transfer, use an internal endpoint or an OSS accelerator endpoint to mount from an instance within a VPC in the same region. Avoid using a public endpoint to access ossfs. High latency and unstable internet connections often lead to performance issues.

   # The endpoint of the region where the bucket is located
   --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
   
   # The bucket name
   --oss_bucket=bucketName
   
   # Mount in read-only mode
   --ro=true

Mount and access

1. Create a mount point.

   You can specify a custom name and path for the mount point. For example, create the /tmp/ossfs2-bucket directory to serve as the mount point.

   sudo mkdir /tmp/ossfs2-bucket

2. Mount the bucket.

   Run the following command to mount the bucket configured in the ossfs2.conf file to the local /tmp/ossfs2-bucket/ directory in read-only mode. If you need to mount with read and write permissions, remove the --ro=true option from the ossfs2.conf configuration file.

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

3. Access the mounted bucket.

   Once mounted, you can access the objects in the bucket as if they were local files. For example, run the sudo ls -lh /tmp/ossfs2-bucket/ command to list the files in the mounted bucket.

   

4. Unmount the bucket.

   To unmount the bucket, run the following command.

   sudo umount /tmp/ossfs2-bucket/ 

References

• Overview of ossfs 2.0

• Configure ossfs 2.0

• Mount options for ossfs 2.0

• Mount a bucket to a local system using ossfs 2.0