Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rexray/rexray
REX-Ray is a container storage orchestration engine enabling persistence for cloud native workloads
https://github.com/rexray/rexray
containers docker go kubernetes mesos rex-ray storage-orchestration storage-providers
Last synced: 6 days ago
JSON representation
REX-Ray is a container storage orchestration engine enabling persistence for cloud native workloads
- Host: GitHub
- URL: https://github.com/rexray/rexray
- Owner: rexray
- License: apache-2.0
- Created: 2015-04-14T03:53:58.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-09-02T05:53:33.000Z (over 1 year ago)
- Last Synced: 2024-11-29T10:56:55.043Z (13 days ago)
- Topics: containers, docker, go, kubernetes, mesos, rex-ray, storage-orchestration, storage-providers
- Language: Go
- Homepage: http://rexray.io
- Size: 47.5 MB
- Stars: 2,173
- Watchers: 85
- Forks: 327
- Open Issues: 293
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
- License: LICENSE
- Code of conduct: .github/code_of_conduct.md
- Authors: AUTHORS.md
Awesome Lists containing this project
- awesome - rexray - REX-Ray is a container storage orchestration engine enabling persistence for cloud native workloads (Go)
- awesome-repositories - rexray/rexray - REX-Ray is a container storage orchestration engine enabling persistence for cloud native workloads (Go)
- awesome-swarm - RexRay - A container storage orchestration engine. (RIP / Articles and Sample Code)
- awesome-docker - REX-Ray
- awesome-golang-repositories - rexray - Ray is a container storage orchestration engine enabling persistence for cloud native workloads (Repositories)
- awesome-docker - REX-Ray
- awesome-list-docker - rexray - Ray is a container storage orchestration engine enabling persistence for cloud native workloads (mesos)
- awesome - rexray/rexray - REX-Ray is a container storage orchestration engine enabling persistence for cloud native workloads (kubernetes)
README
# REX-Ray [](http://godoc.org/github.com/rexray/rexray) [](https://travis-ci.org/rexray/rexray) [](http://goreportcard.com/report/rexray/rexray) [](https://codecov.io/github/rexray/rexray?branch=master) [  ](https://dl.bintray.com/rexray/rexray/stable/latest/)
---
 **Note:** _All hosted `unstable` and `staged` binaries older than `0.11.2-rc1` have
been pruned due to quota restrictions._
---
The long-term goal of the REX-Ray project is to enable collaboration between
organizations focused on creating enterprise-grade storage plugins for the
Container Storage Interface (CSI). As a rapidly changing specification, CSI
support within REX-Ray will be planned when CSI reaches version 1.0, currently
projected for a late 2018 release. In the interim, there remains active
engagement with the project to support the community.
REX-Ray provides a vendor agnostic storage orchestration engine. The primary
design goal is to provide persistent storage for `Docker`, `Kubernetes`, and `Mesos`.
It is additionally available as a Go package, CLI tool, and Linux service which
enables it to be used for additional use cases.
## Documentation [](http://rexray.readthedocs.org/en/stable/)
You will find complete documentation for REX-Ray at [rexray.readthedocs.org](http://rexray.readthedocs.org/en/stable/), including
[licensing](http://rexray.readthedocs.org/en/stable/about/license/) and
[support](http://rexray.readthedocs.org/en/stable/#getting-help) information.
Documentation provided at RTD is based on the latest stable build. The `/.docs`
directory in this repo will refer to the latest or specific commit.
## Architecture
REX-Ray is available as a standalone process today and as a distributed
model of client-server. The `client` performs a level 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/
### Storage Provider Support
The following storage providers and platforms are supported by REX-Ray.
| Provider | Storage Platform | [Docker](https://docs.docker.com/engine/extend/plugins_volume/) | Containerized |
|-----------------------|----------------------|:---:|:---:|
| Amazon EC2 | [EBS](.docs/user-guide/storage-providers/aws.md#aws-ebs) | ✓ | ✓ |
| | [EFS](.docs/user-guide/storage-providers/aws.md#aws-efs) | ✓ | ✓ |
| | [S3FS](.docs/user-guide/storage-providers/aws.md#aws-s3fs) | ✓ | ✓ |
| Ceph | [RBD](.docs/user-guide/storage-providers/ceph.md#ceph-rbd) | ✓ | ✓ |
| Dell EMC | [Isilon](.docs/user-guide/storage-providers/dellemc.md#dell-emc-isilon) | ✓ | ✓ |
| | [ScaleIO](.docs/user-guide/storage-providers/dellemc.md#dell-emc-scaleio) | ✓ | ✓ |
| DigitalOcean | [Block Storage](.docs/user-guide/storage-providers/digitalocean.md#do-block-storage) | ✓ | ✓ |
| FittedCloud | [EBS Optimizer](.docs/user-guide/storage-providers/fittedcloud.md#ebs-optimizer) | ✓ | |
| Google | [GCE Persistent Disk](.docs/user-guide/storage-providers/google.md#gce-persistent-disk) | ✓ | ✓ |
| Microsoft | [Azure Unmanaged Disk](.docs/user-guide/storage-providers/microsoft.md#azure-ud) | ✓ | ✓ |
| OpenStack | [Cinder](.docs/user-guide/storage-providers/openstack.md#cinder) | ✓ | ✓ |
| VirtualBox | [Virtual Media](.docs/user-guide/storage-providers/virtualbox.md#virtualbox) | ✓ | |
### Operating System Support
The following operating systems are supported by REX-Ray:
| OS | Command Line | Service |
|---------------|:---:|:---:|
| Ubuntu 12+ | ✓ | ✓ |
| Debian 6+ | ✓ | ✓ |
| RedHat | ✓ | ✓ |
| CentOS 6+ | ✓ | ✓ |
| CoreOS | ✓ | ✓ |
| TinyLinux (boot2docker)| ✓ | ✓ |
| OS X Yosemite+ | ✓ | |
| Windows | | |
## Installation
The following command will install the REX-Ray client-server tool. If using
`CentOS`, `Debian`, `RHEL`, or `Ubuntu` the necessary service manager is used
to bootstrap the process on startup
`curl -sSL https://rexray.io/install | sh -`
## Runtime - CLI
REX-Ray can be run as an interactive CLI to perform volume management
capabilities.
```bash
$ export REXRAY_SERVICE=ebs
$ export EBS_ACCESSKEY=access_key
$ export EBS_SECRETKEY=secret_key
$ rexray volume ls
ID Name Status Size
vol-6ac6c7d6 attached 8
```
## Runtime - Service (Docker)
Additionally, it can be run as a service to support `Docker`, `Mesos`, and other
platforms that can communicate through `HTTP/JSON`.
```bash
$ export REXRAY_SERVICE=ebs
$ export EBS_ACCESSKEY=access_key
$ export EBS_SECRETKEY=secret_key
$ rexray service start
Starting REX-Ray...SUCCESS!
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 -h /test
```
## Runtime - Docker Plugin
Starting with Docker 1.13, Docker now supports a new plugin architecture in
which plugins can be installed as containers.
```bash
$ docker plugin install rexray/ebs EBS_ACCESSKEY=access_key EBS_SECRETKEY=secret_key
Plugin "rexray/ebs:latest" is requesting the following privileges:
- network: [host]
- mount: [/dev]
- allow-all-devices: [true]
- capabilities: [CAP_SYS_ADMIN]
Do you grant the above permissions? [y/N] y
latest: Pulling from rexray/ebs
2ef3a0b3d192: Download complete
Digest: sha256:86a3bf7fdab857c955d7ef3fb94c01e350e34ba0f7fd3d0bd485e45f1592e1c2
Status: Downloaded newer image for rexray/ebs:latest
Installed plugin rexray/ebs:latest
$ docker plugin ls
ID NAME DESCRIPTION ENABLED
450420731dc3 rexray/ebs:latest REX-Ray for Amazon EBS true
$ docker run -ti --volume-driver=rexray/ebs -v test:/test busybox
$ df -h /test
```