mirror of https://github.com/ceph/ceph
142 lines
3.6 KiB
ReStructuredText
142 lines
3.6 KiB
ReStructuredText
.. _mgr-rgw-module:
|
|
|
|
RGW Module
|
|
============
|
|
The rgw module provides a simple interface to deploy RGW multisite.
|
|
It helps with bootstrapping and configuring RGW realm, zonegroup and
|
|
the different related entities.
|
|
|
|
Enabling
|
|
--------
|
|
|
|
The *rgw* module is enabled with::
|
|
|
|
ceph mgr module enable rgw
|
|
|
|
|
|
RGW Realm Operations
|
|
-----------------------
|
|
|
|
Bootstrapping RGW realm creates a new RGW realm entity, a new zonegroup,
|
|
and a new zone. It configures a new system user that can be used for
|
|
multisite sync operations. Under the hood this module instructs the
|
|
orchestrator to create and deploy the corresponding RGW daemons. The module
|
|
supports both passing the arguments through the cmd line or as a spec file:
|
|
|
|
.. prompt:: bash #
|
|
|
|
rgw realm bootstrap [--realm-name] [--zonegroup-name] [--zone-name] [--port] [--placement] [--start-radosgw]
|
|
|
|
The command supports providing the configuration through a spec file (`-i option`):
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph rgw realm bootstrap -i myrgw.yaml
|
|
|
|
Following is an example of RGW mutlisite spec file:
|
|
|
|
.. code-block:: yaml
|
|
|
|
rgw_realm: myrealm
|
|
rgw_zonegroup: myzonegroup
|
|
rgw_zone: myzone
|
|
placement:
|
|
hosts:
|
|
- ceph-node-1
|
|
- ceph-node-2
|
|
spec:
|
|
rgw_frontend_port: 5500
|
|
|
|
.. note:: The spec file used by RGW has the same format as the one used by the orchestrator. Thus,
|
|
the user can provide any orchestration supported rgw parameters including advanced
|
|
configuration features such as SSL certificates etc.
|
|
|
|
Users can also specify custom zone endpoints in the spec (or through the cmd line). In this case, no
|
|
cephadm daemons will be launched. Following is an example RGW spec file with zone endpoints:
|
|
|
|
.. code-block:: yaml
|
|
|
|
rgw_realm: myrealm
|
|
rgw_zonegroup: myzonegroup
|
|
rgw_zone: myzone
|
|
zone_endpoints: http://<rgw_host1>:<rgw_port1>, http://<rgw_host2>:<rgw_port2>
|
|
|
|
|
|
Realm Credentials Token
|
|
-----------------------
|
|
|
|
Users can list the available tokens for the created (or already existing) realms.
|
|
The token is a base64 string that encapsulates the realm information and its
|
|
master zone endpoint authentication data. Following is an example of
|
|
the `ceph rgw realm tokens` output:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph rgw realm tokens | jq
|
|
|
|
.. code-block:: json
|
|
|
|
[
|
|
{
|
|
"realm": "myrealm1",
|
|
"token": "ewogICAgInJlYWxtX25hbWUiOiAibXlyZWFs....NHlBTFhoIgp9"
|
|
},
|
|
{
|
|
"realm": "myrealm2",
|
|
"token": "ewogICAgInJlYWxtX25hbWUiOiAibXlyZWFs....RUU12ZDB0Igp9"
|
|
}
|
|
]
|
|
|
|
User can use the token to pull a realm to create secondary zone on a
|
|
different cluster that syncs with the master zone on the primary cluster
|
|
by using `ceph rgw zone create` command and providing the corresponding token.
|
|
|
|
Following is an example of zone spec file:
|
|
|
|
.. code-block:: yaml
|
|
|
|
rgw_zone: my-secondary-zone
|
|
rgw_realm_token: <token>
|
|
placement:
|
|
hosts:
|
|
- ceph-node-1
|
|
- ceph-node-2
|
|
spec:
|
|
rgw_frontend_port: 5500
|
|
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph rgw zone create -i zone-spec.yaml
|
|
|
|
.. note:: The spec file used by RGW has the same format as the one used by the orchestrator. Thus,
|
|
the user can provide any orchestration supported rgw parameters including advanced
|
|
configuration features such as SSL certificates etc.
|
|
|
|
Commands
|
|
--------
|
|
::
|
|
|
|
ceph rgw realm bootstrap -i spec.yaml
|
|
|
|
Create a new realm + zonegroup + zone and deploy rgw daemons via the
|
|
orchestrator using the information specified in the YAML file.
|
|
|
|
::
|
|
|
|
ceph rgw realm tokens
|
|
|
|
List the tokens of all the available realms
|
|
|
|
::
|
|
|
|
ceph rgw zone create -i spec.yaml
|
|
|
|
Join an existing realm by creating a new secondary zone (using the realm token)
|
|
|
|
::
|
|
|
|
ceph rgw admin [*]
|
|
|
|
RGW admin command
|