Object Storage Service:Use ossfs to mount an OSS bucket to a Linux system

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 use ossfs, you must create a configuration file that contains your bucket information and access credentials. You can then reference this file when you mount a bucket.

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

   Use ROS scripts to quickly create a RAM user with permissions to manage OSS and its AccessKey pair

   1. Go to the Create Stack page of the Resource Orchestration Service (ROS) console. In the Security Confirmation section, select the check box. Then, click Create.

      

   2. Copy the newly created AccessKey pair on the Outputs tab after you create the RAM resources.

      

2. Configure the environment variables for the credentials that are used to access OSS.

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

3. 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. Enter the mount information. The following configuration is an example of mounting an entire bucket in read-only mode.

   Note

   To obtain the endpoint for a bucket, go to the Buckets page. Select the target bucket. In the left-side navigation pane, 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, mount buckets from instances that are in a VPC in the same region using an internal or OSS accelerator Endpoint. Do not use a public Endpoint to access 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 directory for the mount point.

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

   mkdir /tmp/ossfs2-bucket

2. Mount the bucket.

   The following command mounts the bucket specified in ossfs2.conf 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 configuration 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 in the same way that you access 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.

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

   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.