ceph/doc/radosgw/index.rst
Ali Maredia 56c7cc8c59 rgw: misc labeled op counters work
Highlights of this commit include:
- splitting the rgw perf counters cache int two
caches for bucket labeled and user labeled op counters
- add config overrides to verify suite for CI
- add tenant label for op counters
- misc cleanup cleanup
- add docs for rgw metrics

Signed-off-by: Ali Maredia <amaredia@redhat.com>
2023-10-12 15:46:08 -04:00

89 lines
3.3 KiB
ReStructuredText

.. _object-gateway:
=====================
Ceph Object Gateway
=====================
:term:`Ceph Object Gateway` is an object storage interface built on top of
``librados``. It provides a RESTful gateway between applications and Ceph
Storage Clusters. :term:`Ceph Object Storage` supports two interfaces:
#. **S3-compatible:** Provides object storage functionality with an interface
that is compatible with a large subset of the Amazon S3 RESTful API.
#. **Swift-compatible:** Provides object storage functionality with an interface
that is compatible with a large subset of the OpenStack Swift API.
Ceph Object Storage uses the Ceph Object Gateway daemon (``radosgw``), an HTTP
server designed for interacting with a Ceph Storage Cluster. The Ceph Object
Gateway provides interfaces that are compatible with both Amazon S3 and
OpenStack Swift, and it has its own user management. Ceph Object Gateway can
store data in the same Ceph Storage Cluster in which data from Ceph File System
clients and Ceph Block Device clients is stored. The S3 API and the Swift API
share a common namespace, which makes it possible to write data to a Ceph
Storage Cluster with one API and then retrieve that data with the other API.
.. ditaa::
+------------------------+ +------------------------+
| S3 compatible API | | Swift compatible API |
+------------------------+-+------------------------+
| radosgw |
+---------------------------------------------------+
| librados |
+------------------------+-+------------------------+
| OSDs | | Monitors |
+------------------------+ +------------------------+
.. note:: Ceph Object Storage does **NOT** use the Ceph Metadata Server.
.. toctree::
:maxdepth: 1
HTTP Frontends <frontends>
Multisite Configuration <multisite>
Pool Placement and Storage Classes <placement>
Multisite Sync Policy Configuration <multisite-sync-policy>
Configuring Pools <pools>
Config Reference <config-ref>
Admin Guide <admin>
S3 API <s3>
Data caching and CDN <rgw-cache.rst>
Swift API <swift>
Admin Ops API <adminops>
Python binding <api>
Export over NFS <nfs>
OpenStack Keystone Integration <keystone>
OpenStack Barbican Integration <barbican>
HashiCorp Vault Integration <vault>
KMIP Integration <kmip>
Open Policy Agent Integration <opa>
Multi-tenancy <multitenancy>
Compression <compression>
LDAP Authentication <ldap-auth>
Server-Side Encryption <encryption>
Bucket Policy <bucketpolicy>
Dynamic bucket index resharding <dynamicresharding>
Multi factor authentication <mfa>
Sync Modules <sync-modules>
Bucket Notifications <notifications>
Data Layout in RADOS <layout>
STS <STS>
STS Lite <STSLite>
Keycloak <keycloak>
Session Tags <session-tags>
Role <role>
Orphan List and Associated Tooling <orphans>
OpenID Connect Provider <oidc>
troubleshooting
Manpage radosgw <../../man/8/radosgw>
Manpage radosgw-admin <../../man/8/radosgw-admin>
QAT Acceleration for Encryption and Compression <qat-accel>
S3-select <s3select>
Lua Scripting <lua-scripting>
D3N Data Cache <d3n_datacache>
Cloud Transition <cloud-transition>
Metrics <metrics>