Aliyun Object Storage Service

Slack Docker Pulls GitHub edit source

This guide describes how to configure Aliyun OSS as Alluxio’s under storage system. Object Storage Service (OSS) is a massive, secure and highly reliable cloud storage service provided by Aliyun.


The Alluxio binaries must be on your machine. You can either compile Alluxio, or download the binaries locally.

In preparation for using OSS with Alluxio, follow the OSS quick start guide to sign up for OSS and create an OSS bucket.

Basic Setup

To configure Alluxio to use OSS as under storage, you will need to modify the configuration file conf/ If the file does not exist, create the configuration file from the template.

$ cp conf/ conf/

Edit conf/ file to set the under storage address to the OSS bucket and the OSS directory you want to mount to Alluxio. For example, the under storage address can be oss://alluxio-bucket/ if you want to mount the whole bucket to Alluxio, or oss://alluxio-bucket/alluxio/data if only the directory /alluxio/data inside the oss bucket alluxio-bucket is mapped to Alluxio.


Specify the Aliyun credentials for OSS access. In conf/, add:


fs.oss.accessKeyId and fs.oss.accessKeySecret is the AccessKey for OSS, which are created and managed in Aliyun AccessKey management console.

fs.oss.endpoint is the internet endpoint of this bucket, which can be found in the bucket overview page with values like and Available endpoints are listed in the OSS Internet Endpoints documentation.

Example: Running Alluxio Locally with OSS

Start the Alluxio servers:

$ ./bin/alluxio format
$ ./bin/ local

This will start an Alluxio master and an Alluxio worker. You can see the master UI at http://localhost:19999.

Run a simple example program:

$ ./bin/alluxio runTests

Visit your OSS directory oss://<OSS_BUCKET>/<OSS_DIRECTORY> to verify the files and directories created by Alluxio exist. For this test, you should see files named like <OSS_BUCKET>/<OSS_DIRECTORY>/default_tests_files/BasicFile_CACHE_PROMOTE_MUST_CACHE.

Stop Alluxio by running:

$ ./bin/ local

Advanced Setup

Nested Mount

An OSS location can be mounted at a nested directory in the Alluxio namespace to have unified access to multiple under storage systems. Alluxio’s Mount Command can be used for this purpose. For example, the following command mounts a directory inside an OSS bucket into Alluxio directory /oss:

$ ./bin/alluxio fs mount --option fs.oss.accessKeyId=<OSS_ACCESS_KEY_ID> \
  --option fs.oss.accessKeySecret=<OSS_ACCESS_KEY_SECRET> \
  --option fs.oss.endpoint=<OSS_ENDPOINT> \
  /oss oss://<OSS_BUCKET>/<OSS_DIRECTORY>/