2012-06-26 15:21:05 +00:00
|
|
|
===============
|
|
|
|
|
RADOS Gateway
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
RADOS Gateway is an object storage interface built on top of ``librados`` to
|
|
|
|
|
provide applications with a RESTful gateway to RADOS clusters. The RADOS Gateway
|
|
|
|
|
supports two interfaces:
|
|
|
|
|
|
|
|
|
|
#. **S3-compatible:** Provides block storage functionality with an interface that
|
|
|
|
|
is compatible with a large subset of the Amazon S3 RESTful API.
|
|
|
|
|
|
|
|
|
|
#. **Swift-compatible:** Provides block storage functionality with an interface
|
|
|
|
|
that is compatible with a large subset of the OpenStack Swift API.
|
2012-10-01 21:09:21 +00:00
|
|
|
|
2012-06-26 15:21:05 +00:00
|
|
|
RADOS Gateway is a FastCGI module for interacting with ``librados``. Since it
|
|
|
|
|
provides interfaces compatible with OpenStack Swift and Amazon S3, RADOS Gateway
|
|
|
|
|
has its own user management. RADOS Gateway can store data in the same RADOS
|
|
|
|
|
cluster used to store data from Ceph FS clients or RADOS block devices.
|
2012-10-01 21:09:21 +00:00
|
|
|
The S3 and Swift APIs share a common namespace, so you may write data with
|
|
|
|
|
one API and retrieve it with the other.
|
|
|
|
|
|
|
|
|
|
.. ditaa:: +------------------------+ +------------------------+
|
|
|
|
|
| S3 compatible API | | Swift compatible API |
|
|
|
|
|
+------------------------+-+------------------------+
|
|
|
|
|
| radosgw |
|
|
|
|
|
+---------------------------------------------------+
|
2012-10-01 21:53:57 +00:00
|
|
|
| librados |
|
2012-10-01 21:09:21 +00:00
|
|
|
+------------------------+-+------------------------+
|
|
|
|
|
| OSDs | | Monitors |
|
|
|
|
|
+------------------------+ +------------------------+
|
|
|
|
|
|
|
|
|
|
.. note:: RADOS Gateway does **NOT** use the CephFS metadata server.
|
|
|
|
|
|
2012-06-26 15:21:05 +00:00
|
|
|
|
|
|
|
|
.. toctree::
|
2012-06-26 15:28:10 +00:00
|
|
|
:maxdepth: 1
|
2012-06-26 15:21:05 +00:00
|
|
|
|
|
|
|
|
Manual Install <manual-install>
|
|
|
|
|
Configuration <config>
|
|
|
|
|
Config Reference <config-ref>
|
2012-10-10 22:15:32 +00:00
|
|
|
Purging Temp Data <purge-temp>
|
2012-06-26 15:21:05 +00:00
|
|
|
S3 API <s3>
|
2012-12-12 00:44:46 +00:00
|
|
|
Swift API <swift>
|
2012-09-25 23:38:29 +00:00
|
|
|
Admin API <admin/index>
|
2012-09-19 23:25:49 +00:00
|
|
|
troubleshooting
|
2012-11-14 22:57:51 +00:00
|
|
|
Manpage radosgw <../../man/8/radosgw>
|
|
|
|
|
Manpage radosgw-admin <../../man/8/radosgw-admin>
|
2012-10-08 21:30:17 +00:00
|
|
|
|
