Skip to content
Alluxio, data orchestration for analytics and machine learning in the cloud
Branch: master
Clone or download
haoyuan and alluxio-bot [DOCFIX] Improve allxio-path.md and docs/README.md
Auto cherry-pick of existing commit.
orig-pr: #9144
orig-commit: f0f2016
orig-commit-author: Haoyuan Li <haoyuan.li@gmail.com>

pr-link: #9144
change-id: cid-d825385d4e71a210f2f1651be818a0fcd4df7334
Latest commit 65aef6a May 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Mar 21, 2019
assembly Update alluxio code base to point to alluxio.io May 9, 2019
bin Add a white list to the monitor script May 24, 2019
build Add non-generated gRPC classes under checkstyle/findbugs coverage Apr 26, 2019
conf Update alluxio code base to point to alluxio.io May 9, 2019
core Update checkConsistency to compare fingerprint May 24, 2019
deploy/vagrant Update alluxio code base to point to alluxio.io May 9, 2019
dev Remove useless links in alluxio-*.tar.gz May 17, 2019
docs [DOCFIX] Improve allxio-path.md and docs/README.md May 26, 2019
examples Update ufs:getStatus contract to throw FileNotFoundException May 24, 2019
integration Add usage for new docker entrypoint commands May 25, 2019
job Pin to specific tier, phase 2 May 21, 2019
libexec Improve user logging file structure Apr 17, 2019
logs Add logs/README.md Feb 26, 2016
logserver Remove Singleton Configuration (#8294) Jan 25, 2019
minicluster Consolidate journal tools May 22, 2019
shaded Move shaded module from a top module to a submodule inside underfs May 3, 2019
shell Add a command to enable updating mount options May 22, 2019
templates Use Swagger to generate rest docs May 17, 2019
tests Replace atomic counter with CountLatch in FileSystemContextReinitializer May 24, 2019
underfs Update ufs:getStatus contract to throw FileNotFoundException May 24, 2019
webui Rename module alluxio-ui to webui for consistency May 10, 2019
.gitignore Use Swagger to generate rest docs May 17, 2019
LICENSE Migrate to ForkJoinPool for master RPCs Apr 17, 2019
NOTICE Jira 2868 Rename file tests/src/test/java/alluxio/shell/command/Leade… Jun 25, 2017
README.md Update alluxio code base to point to alluxio.io May 9, 2019
pom.xml Fix generate-tarballs - exclude generated restdoc from license check May 20, 2019

README.md

logo

Slack Release Docker Pulls Documentation Twitter Follow License

What is Alluxio

Alluxio (formerly known as Tachyon) is a virtual distributed storage system. It bridges the gap between computation frameworks and storage systems, enabling computation applications to connect to numerous storage systems through a common interface. Read more about Alluxio Overview.

The Alluxio project originated from a research project called Tachyon at AMPLab, UC Berkeley, which was the data layer of the Berkeley Data Analytics Stack (BDAS). For more details, please refer to Haoyuan Li's PhD dissertation Alluxio: A Virtual Distributed File System.

Who Uses Alluxio

Alluxio is used in production to manage Petabytes of data in many leading companies, with the largest deployment exceeding 1300 nodes. Find more use cases at Powered by Alluxio.

Community and Events

Please use the following to reach members of the community:

Download Alluxio

Binary download

Prebuilt binaries are available to download at https://www.alluxio.io/download .

Docker

Download and start an Alluxio master and a worker. More details can be found in documentation.

# launch a master
$ docker run -d --net=host\
    -v /mnt/data:/opt/alluxio/underFSStorage\
    alluxio/alluxio master
# launch a worker
$ docker run -d --net=host --shm-size=1G\
    -e ALLUXIO_WORKER_MEMORY_SIZE=1G\
    -v /mnt/data:/opt/alluxio/underFSStorage\
    -e ALLUXIO_MASTER_HOSTNAME=localhost\
    alluxio/alluxio worker

MacOS Homebrew

$ brew install alluxio

Quick Start

Please follow the Guide to Get Started to run a simple example with Alluxio.

Report a Bug

To report bugs, suggest improvements, or create new feature requests, please open a Github Issue. Our previous Alluxio JIRA system has been deprecated since December 2018.

Depend on Alluxio

For Alluxio versions 1.4 or earlier, use the alluxio-core-client artifact.

For Alluxio versions 1.5 or later, Alluxio provides several different client artifacts. The Alluxio file system interface provided by the alluxio-core-client-fs artifact is recommended for the best performance and access to Alluxio-specific functionality. If you want to use other interfaces, include the appropriate client artifact. For example, alluxio-core-client-hdfs provides a client implementing HDFS's file system API.

Apache Maven

<dependency>
  <groupId>org.alluxio</groupId>
  <artifactId>alluxio-core-client-fs</artifactId>
  <version>1.8.1</version>
</dependency>

SBT

libraryDependencies += "org.alluxio" % "alluxio-core-client-fs" % "1.8.1"

Contributing

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so. For a more detailed step-by-step guide, please read how to contribute to Alluxio. For new contributor, please take 2 new contributor tasks.

Useful Links

You can’t perform that action at this time.