mirror of https://github.com/ceph/ceph
49 lines
1.9 KiB
ReStructuredText
49 lines
1.9 KiB
ReStructuredText
===============
|
|
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.
|
|
|
|
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.
|
|
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 |
|
|
+---------------------------------------------------+
|
|
| librados |
|
|
+------------------------+-+------------------------+
|
|
| OSDs | | Monitors |
|
|
+------------------------+ +------------------------+
|
|
|
|
.. note:: RADOS Gateway does **NOT** use the CephFS metadata server.
|
|
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
Manual Install <manual-install>
|
|
Configuration <config>
|
|
Config Reference <config-ref>
|
|
Purging Temp Data <purge-temp>
|
|
S3 API <s3>
|
|
Swift API <swift>
|
|
Admin API <admin/index>
|
|
troubleshooting
|
|
Manpage radosgw <../../man/8/radosgw>
|
|
Manpage radosgw-admin <../../man/8/radosgw-admin>
|
|
|