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

Prerequisites

• Register an Alibaba Cloud account.

• Activate OSS and create an OSS bucket.

Operating environment

ossfs 2.0 uses Filesystem in Userspace (FUSE).

Install ossfs 2.0

Configure ossfs 2.0

To mount a bucket, you must create a configuration file that contains your bucket information and access credentials. This file is referenced during the mount process.

1. Create an AccessKey pair for a Resource Access Management (RAM) user that has OSS management permissions.

   Use a Resource Orchestration Service (ROS) script to quickly create a RAM user with OSS management permissions and an AccessKey pair

   1. Go to the Create Stack page of the ROS console. In the Security Confirmation section, select the check box, and then click Create.

      

   2. After the stack is created, copy the new AccessKey pair from the Outputs tab.

      

2. Configure the environment variables for your OSS access credentials.

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

3. You can set the file name and path for the ossfs 2.0 configuration file. For example, you can create the /etc/ossfs2.conf file.

   sudo touch /etc/ossfs2.conf

4. Add the mount information to the configuration file. The following example shows the configuration for mounting an entire bucket in read-only mode.

   Note

   To view the endpoint for a bucket, go to the Buckets page. Select the target bucket. In the navigation pane on the left, click Overview. On the Overview page, find the region in the Port section. The following figure shows an example for a bucket in the China (Hangzhou) region.

   

   Open the ossfs 2.0 configuration file that you created. Configure the file based on the following example, which uses an internal Endpoint in the China (Hangzhou) region, and then save the file. To ensure faster and more stable data transmission, use an internal or OSS accelerator Endpoint to mount buckets from an instance that is in a VPC in the same region. Do not use a public Endpoint with ossfs because high latency and unstable internet connectivity can cause stuttering.

   # 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 directory.

   You can specify the path for the mount directory as needed. For example, create the /tmp/ossfs2-bucket directory.

   mkdir /tmp/ossfs2-bucket

2. Execute the mount command.

   Run the following command to mount the bucket specified in the ossfs2.conf file. The bucket is mounted to the local /tmp/ossfs2-bucket/ directory in read-only mode. To mount the bucket in read/write mode, remove the --ro=true option from the ossfs2.conf file.

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

3. Access the mounted bucket.

   After the bucket is mounted, you can access the objects in the bucket as you would 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.

   When you no longer need the mounted bucket, run the following command to unmount it.

   sudo umount /tmp/ossfs2-bucket/

References

• ossfs 2.0 Overview

• Configure ossfs 2.0.

• For more information, see Mount options for ossfs 2.0.

• For more information, see Mount a bucket to a local system using ossfs 2.0.