projects / ceph.git / blame
| Commit | Line | Data |
|---|---|---|
| 91327a77 AA |
1 | .. _object-gateway: |
| 2 | ||
| 7c673cae FG |
3 | ===================== |
| 4 | Ceph Object Gateway | |
| 5 | ===================== | |
| 6 | ||
| 7 | :term:`Ceph Object Gateway` is an object storage interface built on top of | |
| 8 | ``librados`` to provide applications with a RESTful gateway to | |
| 9 | Ceph Storage Clusters. :term:`Ceph Object Storage` supports two interfaces: | |
| 10 | ||
| 11 | #. **S3-compatible:** Provides object storage functionality with an interface | |
| 12 | that is compatible with a large subset of the Amazon S3 RESTful API. | |
| 13 | ||
| 14 | #. **Swift-compatible:** Provides object storage functionality with an interface | |
| 15 | that is compatible with a large subset of the OpenStack Swift API. | |
| 16 | ||
| 17 | Ceph Object Storage uses the Ceph Object Gateway daemon (``radosgw``), which is | |
| 31f18b77 | 18 | an HTTP server for interacting with a Ceph Storage Cluster. Since it |
| 7c673cae FG |
19 | provides interfaces compatible with OpenStack Swift and Amazon S3, the Ceph |
| 20 | Object Gateway has its own user management. Ceph Object Gateway can store data | |
| 21 | in the same Ceph Storage Cluster used to store data from Ceph Filesystem clients | |
| 22 | or Ceph Block Device clients. The S3 and Swift APIs share a common namespace, so | |
| 23 | you may write data with one API and retrieve it with the other. | |
| 24 | ||
| 25 | .. ditaa:: +------------------------+ +------------------------+ | |
| 26 | | S3 compatible API | | Swift compatible API | | |
| 27 | +------------------------+-+------------------------+ | |
| 28 | | radosgw | | |
| 29 | +---------------------------------------------------+ | |
| 30 | | librados | | |
| 31 | +------------------------+-+------------------------+ | |
| 32 | | OSDs | | Monitors | | |
| 33 | +------------------------+ +------------------------+ | |
| 34 | ||
| 35 | .. note:: Ceph Object Storage does **NOT** use the Ceph Metadata Server. | |
| 36 | ||
| 37 | ||
| 38 | .. toctree:: | |
| 39 | :maxdepth: 1 | |
| 40 | ||
| 41 | Manual Install w/Civetweb <../../install/install-ceph-gateway> | |
| 94b18763 | 42 | HTTP Frontends <frontends> |
| a8e16298 | 43 | Pool Placement <placement> |
| 7c673cae | 44 | Multisite Configuration <multisite> |
| 31f18b77 | 45 | Configuring Pools <pools> |
| 7c673cae FG |
46 | Config Reference <config-ref> |
| 47 | Admin Guide <admin> | |
| 48 | S3 API <s3> | |
| 49 | Swift API <swift> | |
| 50 | Admin Ops API <adminops> | |
| 51 | Python binding <api> | |
| 224ce89b | 52 | Export over NFS <nfs> |
| 7c673cae FG |
53 | OpenStack Keystone Integration <keystone> |
| 54 | OpenStack Barbican Integration <barbican> | |
| 55 | Multi-tenancy <multitenancy> | |
| 56 | Compression <compression> | |
| 224ce89b | 57 | LDAP Authentication <ldap-auth> |
| 7c673cae | 58 | Server-Side Encryption <encryption> |
| 31f18b77 | 59 | Bucket Policy <bucketpolicy> |
| 7c673cae | 60 | Data Layout in RADOS <layout> |
| 7c673cae FG |
61 | troubleshooting |
| 62 | Manpage radosgw <../../man/8/radosgw> | |
| 63 | Manpage radosgw-admin <../../man/8/radosgw-admin> |