Skip to content

ltouati/rexray

 
 

Repository files navigation

REX-Ray GoDoc Build Status Go Report Card Coverage Status Download

REX-Ray provides a vendor agnostic storage orchestration engine. The primary design goal is to provide persistent storage for Docker containers as well as Mesos frameworks and tasks.

It is additionally available as a Go package, CLI tool, and Linux service which enables it to be used for additional use cases.

Architecture

It is available as a standalone process today and in the future (0.3) as a distributed model of client-server. The client performs a level of software-defined abstraction of local host processes (request for volume attachment, discovery, format, and mounting of devices) while the server provides the necessary abstraction of the control plane for multiple storage platforms.

Irrespective of platform, REX-Ray provides common functionality for the following.

  • AWS EC2 (EBS)
  • OpenStack (Cinder)
  • EMC ScaleIO
  • EMC XtremIO
  • ..more coming

Operating System Support

By default we prescribe the curl-bash method of installing REX-Ray. Other methods are available, please consult the documentation for more information.

We explicitly support the following operating system distributions.

  • Ubuntu
  • Debian
  • RedHat
  • CentOS
  • CoreOS
  • OSX

Installation

The following command will install the REX-Ray client-server tool. If using CentOS, RedHat, Ubuntu, or Debian the necessary service manager is used to bootstrap the process on startup.

curl -sSL https://dl.bintray.com/emccode/rexray/install | sh -

Runtime - CLI

REX-Ray can be ran as an interactive CLI to perform volume management capabilities.

$ export REXRAY_STORAGEDRIVERS=ec2
$ export AWS_ACCESS_KEY=access_key
$ export AWS_SECRET_KEY=secret_key
$ rexray volume get

- providername: ec2
  instanceid: i-695bb6ab
  volumeid: vol-dedbadc3
  devicename: /dev/sda1
  region: us-west-1
  status: attached

Runtime - Service (Docker)

Additionally, it can be ran as a service to support Docker, Mesos, and other platforms that can communicate through HTTP/JSON.

$ export REXRAY_STORAGEDRIVERS=ec2
$ export AWS_ACCESS_KEY=access_key
$ export AWS_SECRET_KEY=secret_key
$ rexray service start
Starting REX-Ray...SUCESS!

  The REX-Ray daemon is now running at PID XX. To
  shutdown the daemon execute the following command:

    sudo /usr/bin/rexray stop

$ docker run -ti --volume-driver=rexray -v test:/test busybox
$ df /test

Documentation for REX-Ray Docs

You will find complete documentation for REX-Ray at rexray.readthedocs.org, including licensing and support information.

About

REX-Ray provides a vendor agnostic storage orchestration engine.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 88.1%
  • CSS 5.6%
  • Makefile 2.8%
  • Shell 1.7%
  • HTML 1.7%
  • JavaScript 0.1%